https://wiki.stne.net/index.php?feed=atom&target=Arakis&title=Spezial%3ABeitr%C3%A4ge%2FArakisSTNE-Wiki - Benutzerbeiträge [de]2026-04-07T20:23:30ZAus STNE-WikiMediaWiki 1.16.0https://wiki.stne.net/index.php?title=Vorlage:MenueVorlage:Menue2020-09-28T19:57:24Z<p>Arakis: </p>
<hr />
<div>{| width="100%" <br />
! | '''[[Inhalt|Inhalt]]''' | '''[[Inhalt|Inhalt]]''' | '''[[:Kategorie:STNE|STNE]]''' | '''[[:Kategorie:Regeln und Gesetze|Regeln]]''' | '''[[NPC]]''' | '''[[:Kategorie:Kolonien|Kolonien]]''' | '''[[:Kategorie:Gebäude|Gebäude]]''' | '''[[:Kategorie:Waren|Waren]]''' | '''[[:Kategorie:Schiffe|Schiffe]]''' | '''[[:Kategorie:Waffen|Waffen]]''' | '''[[Sternenkartographie]]''' | '''[[:Kategorie:Forschungen|Forschungen]]''' | '''[[:Kategorie:Handel|Handel]]''' | '''[[Siedler]]''' | '''[[:Kategorie:RPG|RPG]]''' | '''[[Support]]''' | '''[[Index]]''' <br />
|}<br />
STNE ist ein Online Strategie- und Rollenspiel. '''[https://game.stne.net <span style="color:rgb(144, 238, 144)">Du kannst hier mitspielen</span>]'''.<br />
<div style="padding:4px;"></div></div>Arakishttps://wiki.stne.net/index.php?title=Vorlage:MenueVorlage:Menue2020-09-28T19:51:53Z<p>Arakis: </p>
<hr />
<div>{| width="100%" <br />
! | '''[[Inhalt|Inhalt]]''' | '''[[Inhalt|Inhalt]]''' | '''[[:Kategorie:STNE|STNE]]''' | '''[[:Kategorie:Regeln und Gesetze|Regeln]]''' | '''[[NPC]]''' | '''[[:Kategorie:Kolonien|Kolonien]]''' | '''[[:Kategorie:Gebäude|Gebäude]]''' | '''[[:Kategorie:Waren|Waren]]''' | '''[[:Kategorie:Schiffe|Schiffe]]''' | '''[[:Kategorie:Waffen|Waffen]]''' | '''[[Sternenkartographie]]''' | '''[[:Kategorie:Forschungen|Forschungen]]''' | '''[[:Kategorie:Handel|Handel]]''' | '''[[Siedler]]''' | '''[[:Kategorie:RPG|RPG]]''' | '''[[Support]]''' | '''[[Index]]''' <br />
|}<br />
STNE ist ein Online Strategie- und Rollenspiel. '''[https://game.stne.net Du kannst hier mitspielen]'''.<br />
<div style="padding:4px;"></div></div>Arakishttps://wiki.stne.net/index.php?title=SchiffslimitSchiffslimit2013-04-23T18:14:12Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
<br><br />
<br />
Das '''Schiffslimit''' oder besser das '''Slotlimit''' für Schiffe bestimmt, wie viele Slots ein Siedler maximal mit Schiffen füllen kann. Normalerweise liegt das Limit bei 100 Slots, aber es kann in 10er Schritten gegen [[Credits]] erhöht werden. <br />
<br><br />
Das maximale Limit liegt bei 200 Slots. Es beinhaltet ALLE Schiffe, Raumstationen, Sonden und MVWs - egal ob gekauft, ersteigert oder selbst gebaut. <br />
<br />
<br><br />
[[Optionen]] > [[Credits]] eintauschen > [[Schiffslimit erhöhen]] +10<br />
<br><br />
<br><br />
{{seealso}}<br />
* [[Optionen]]<br />
* [[Schiffslimit erhöhen]]<br />
* [[Credits]]<br />
<br><br />
<br><br />
[[Kategorie:Schiffe]]</div>Arakishttps://wiki.stne.net/index.php?title=SchiffslimitSchiffslimit2013-04-23T18:13:57Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
<br><br />
.<br />
Das '''Schiffslimit''' oder besser das '''Slotlimit''' für Schiffe bestimmt, wie viele Slots ein Siedler maximal mit Schiffen füllen kann. Normalerweise liegt das Limit bei 100 Slots, aber es kann in 10er Schritten gegen [[Credits]] erhöht werden. <br />
<br><br />
Das maximale Limit liegt bei 200 Slots. Es beinhaltet ALLE Schiffe, Raumstationen, Sonden und MVWs - egal ob gekauft, ersteigert oder selbst gebaut. <br />
<br />
<br><br />
[[Optionen]] > [[Credits]] eintauschen > [[Schiffslimit erhöhen]] +10<br />
<br><br />
<br><br />
{{seealso}}<br />
* [[Optionen]]<br />
* [[Schiffslimit erhöhen]]<br />
* [[Credits]]<br />
<br><br />
<br><br />
[[Kategorie:Schiffe]]</div>Arakishttps://wiki.stne.net/index.php?title=SiedlerSiedler2010-08-20T03:52:04Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
== Die Siedler ==<br />
<br />
Als Siedler werden die Spieler von [[STNE]] bezeichnet. Sie konzentrieren sich je nach persönlichen Neigungen, Bedürfnissen und Ressourcen auf verschiedene Aspekte des Spiels. Die Siedler bilden eine von mehreren Bevölkerungsgruppen im [[Delta-Quadrant|Delta-Quadranten]] neben der [[Föderation]] und verschiedenen anderen Machtgruppen. Viele Siedler sind widerum in [[Allianz]]en organisiert, um sich durch eine größere militärische, wirtschaftliche und soziale Machtbasis einen größeren Einfluss in die politischen Geschehnisse des [[Delta-Quadrant|DQ]] zu sichern. Andere bevorzugen es, allein zu agieren.<br />
<br><br />
<br><br />
== Im Wiki beschriebene Siedlerseiten ==<br />
<br />
* [[Spieler:AMJeanLucPicard|AMJeanLucPicard (ID 43506)]]<br />
* [[Spieler:Atlan|Atlan (ID 49592)]]<br />
* [[Spieler:Apofis|Apofis (ID 28774)]]<br />
* [[Spieler:W!Zz4Rd|Borg - Vinkulum 39C[BA] (ID 16475) -W!Zz4Rd-]]<br />
* [[Spieler:Chi|Chi (ID 15944)]]<br />
* [[Spieler:Cortana KI|[UNSC] Cortana <small>KI</small> (ID 51936)]]<br />
* [[Spieler:Degra|Degra (ID 7500)]]<br />
* [[Spieler:Jing|Datura (ID 6228) -Jing-]]<br />
* [[Spieler:El Rolo|El Rolo (ID )]]<br />
* [[Spieler:falcon_gfx|falcon_gfx - Abgesandter des Auridianischen Reiches (ID 21837)]]<br />
* [[Spieler:Xenon|Großadministrator von Ritaka (ID 10127) -Xenon-]]<br />
* [[Spieler:SpaceTribe#Server 3|Großfürstin Thea-Mania von Sanctûar (S3-ID 6214) -SpaceTribe-]]<br />
* [[Spieler:Hirano|Hirano Colonies - Hiranische Freiheitsbewegung (ID S1-54666)]]<br />
* [[Spieler:Humankind Empire of Abh| Humankind Empire of Abh (ID 36384)]]<br />
* [[Spieler:Jack*Black|Jack*Black aka König Minos (ID 17118)]]<br />
* [[Spieler:Jem'Hadar| Jem'Hadar (ID 32006)]]<br />
* [[Spieler:Reed|Julian Reed (ID S1-22100)]]<br />
* [[Spieler:Jörg|Jörg (ID 18598)]]<br />
* [[Spieler:Tadeus Demming|Königreich Som (ID 33357)]]<br />
* [[Spieler:Ll'on Darier|Ll'on Darier (ID )]]<br />
* [[Spieler:Lord Arkanis|Lord Arkanis (ID 23647)]]<br />
* [[Spieler:Lucien Museveni|Lucien Museveni (ID )]]<br />
* [[Spieler:Moritz der Mächtige|Moritz der Mächtige (ID )]]<br />
* [[Spieler:Myselection|Myselection (ID 44964)]]<br />
* [[Spieler:Proximo|Proximo (ID 21617)]]<br />
* [[Spieler:QuentinT|QuentinT (ID 21838)]]<br />
* [[Spieler:Saltok T'Lar|Saltok T'Lar (ID 13804)]]<br />
* [[Spieler:Die Schatten von Maraskan|Die Schatten von Maraskan (ID 16962)]]<br />
* [[Spieler:SpaceTribe|SpaceTribe (ID 30160)]]<br />
* [[Spieler:StarChild|StarChild (ID 30474)]]<br />
* [[Spieler:Thlog'|Thlog' (ID 11190)]]<br />
* [[Spieler:Zakdorn|Thron Teufel (ID 25969) -Zakdorn-]]<br />
* [[Spieler:UNSC Marine Corps|[UNSC] Sir Terrence Hood <small>[*****]</small> (ID 39692)]]<br />
* [[Spieler:Serina| [SEK] United States of Berania (ID 25774) -Serina-]]<br />
* [[Spieler:Vulkanier|Vulkanier]]<br />
* [[Westeros| Westeros (ID 17118)]]<br />
* [[Spieler:Son'a|Son'a (ID 39705)]]<br />
* [[Spieler:Commonwealth (ID 1021)]]<br />
* [[Spieler: Freies Reich von Suruchada (ID 3121)]]<br />
<br />
<br><br />
<i>edit: ich habe mir erlaubt die Liste alphabetisch zu Ordnen -nach InGame-Namen- und wenn nötig die Spieler-Namen zu ergänzen.<br />
<br><br />
Gruß<br />
<br><br />
euer SpaceTribe</i><br />
<br><br />
<br><br />
{{seealso}}<br />
[[:Kategorie:Spieler|Übersicht aller im Wiki registrierten Spieler]]<br />
<br><br />
<br><br />
<br />
[[Kategorie:Spieler| Siedler]]</div>Arakishttps://wiki.stne.net/index.php?title=STNE-Wiki:AdministratorenSTNE-Wiki:Administratoren2010-08-20T03:50:20Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
{{Wiki-Hilfe}}<br />
<br />
Hier findet ihr eine Liste der Administratoren des Wiki. Bitte wendet euch bei Streitfragen rund ums Wiki an die unten stehen Admins. Weitere Hilfe gibt es im Forum und im IRC (Channel #wiki)<br />
<br />
<br />
== aktuelle Wiki-Administratoren ==<br />
* [[Spieler:Arakis|Arakis (ID 1)]]<br />
* [[Spieler:Data|Data (ID 6236 [Server 1])]]<br />
* [[Spieler:Terrell|Terrell (ID 4409 [Server 1])]]<br />
* [[Spieler:Juliuspedia|Atlantropa (DE3-26)]]<br />
<br />
<br />
== Ehemalige Wiki-Administratoren ==<br />
* [[Spieler:Die Schatten von Maraskan|Die Schatten von Maraskan (frühere Server 1-ID: 16962)]]<br />
* [[Spieler:Jelandria|Jelandria Alderion (frühere Server 1-ID: 16976)]]<br />
<br />
[[Kategorie:Wiki-Hilfe|Administratoren]]</div>Arakishttps://wiki.stne.net/index.php?title=API:CBaseShipManagerAPI:CBaseShipManager2010-08-20T01:54:21Z<p>Arakis: </p>
<hr />
<div>{{Vorlage:ApiMenu}}<br />
Die Klasse [[API:CBaseShipManager|CBaseShipManger]] wird benötigt um Aktionen mit einem Schiff durchzuführen.<br />
<br />
Hierzu ist es erstmal notwendig, eine Instanz von [[API:CMyShip|CMyShip]] zu erzeugen:<br />
<br />
[[code|Var Schiff As New CMyShip(123456);]]<br />
<br />
Auf das Schiff mit der NCC 123456 kann man nun sämtliche Methoden des Objektes [[API:CBaseShipManager|CBaseShipManger]] anwenden, da die Eigenschaft [[code|Action]] von [[API:CMyShip|CMyShip]] der Klasse [[API:CBaseShipManager|CBaseShipManager]] entspricht.<br />
<br />
Hier ein kleines Beispiel:<br />
<br />
Var Schiff As New CMyShip(123456);<br />
Var Station As New CMyShip(54321);<br />
<br />
Schiff.Action.CollectOre(20);<br />
Schiff.Action.FlyTo("150|250");<br />
Schiff.Action.EnterOrbit();<br />
Schiff.Action.DockTo(Station.ShipID);<br />
Schiff.Action.TransferToShip(Station.ShipID, 100, EBeamResource.IridiumOre);<br />
Schiff.Action.TransferFromShip(Station.ShipID, 50, EBeamResource.Deuterium);<br />
Schiff.Action.TransferFromShip(54321, 50, EBeamRessource.Food);<br />
Schiff.Action.Undock();<br />
Schiff.Action.LeaveOrbit();<br />
Schiff.Action.FlyTo("152|251");<br />
<br />
In dem Beispiel würde das eigene Schiff die vorgegeben Aktionen ausführen, in dem Fall: Erz sammeln, zu einer Station in einem tiefen Orbit fliegen, Andocken, Erz rüberbeamen, Schiff mit Nahrung sowie Deuterium versorgen und anschließend zurück fliegen.<br />
<br />
Hier eine Liste der gebräuchlichen Methoden von [[API:CBaseShipManager|CBaseShipManager]]:<br />
<br />
''Bitte beachte: Die Aktionen unterliegen den selben Einschränkungen wie im Spiel, d.h. du kannst nur mit anderen Schiffen interagieren, wenn sie im selben Sektor sind oder zum Beispiel auch nur die Schilde laden, wenn sie auch abgekühlt sind.''<br />
<br />
<br />
{|<br />
|-<br />
!Methode !! Parameter !! Erklärung<br />
|-<br />
|ActivateLRS(Status) || [[API:Boolean|Boolean]] || Bei Schiff.Action.ActivateLRS(True) wird das LRS aktiviert, bei "False" deaktiviert<br />
|-<br />
|ActivateReplicators(Status) || [[API:Boolean|Boolean]] || Aktiviert/Deaktiviert den Replikator an Bord<br />
|-<br />
|ActivateShields(Status) || [[API:Boolean|Boolean]] || Schilde aktivieren<br />
|-<br />
|ActivateSRS(Status) || [[API:Boolean|Boolean]] || SRS aktivieren<br />
|-<br />
|ActivateTractorBeam(ShipID) || [[API:Integer|Integer]] || Erfasst das Schiff mit der NCC-Nr "ShipID" im Traktorstrahl<br />
|-<br />
|ActivateWarpCore(Status) || [[API:Boolean|Boolean]] || Warpkern aktivieren<br />
|-<br />
|ApplyGoodsToConstruction() || - || Speißt beim Umbau von Tugs / Stationen die Waren ein<br />
|-<br />
|ChargeEmergencyBattery(ShipID, Menge) || [[API:Integer|Integer]], [[API:Integer|Integer]] || Lädt die Reservebatterie von dem Schiff mit der NCC-Nr "ShipID" um "Menge" Energieeinheiten<br />
|-<br />
|ChargeShields(Menge) || [[API:Integer|Integer]] || Lädt die eigenen Schilde um "Menge" auf.<br />
|-<br />
|CollectDeuterium(Energie) || [[API:Integer|Integer]] || Sammelt mit "Energie" Einheiten Deuterium<br />
|-<br />
|CollectOre(Energie) || [[API:Integer|Integer]] || Extrahiert mit "Energie" Einheiten Erz<br />
|-<br />
|DeactivateTractorBeam() || - || Deaktiviert den Traktorstrahl, in dem ein andere Schiff gehalten wird.<br />
|-<br />
|DischargeEmergencyBattery(Menge) || [[API:Integer|Integer]] || Entlädt die Reservebatterie um "Menge"<br />
|-<br />
|DockTo(ShipID) || [[API:Integer|Integer]] || Dockt an das Schiff/Station mit der NCC-Nr "ShipID" an<br />
|-<br />
|EnterOrbit || - || Betritt den Orbit der Kolonie, über der das Schiff gerade steht<br />
|-<br />
| ExtractFromWreck(Menge) || [[API:Integer|Integer]]<br />
|-<br />
| Fly(AnzahlFelder, Richtung) || [[API:Integer|Integer]], [[API:EShipDirection|EShipDirection]]<br />
|- <br />
| FlyTo(Position) || [[API:String|String]]<br />
|-<br />
| Hide(Versteckt) || [[API:Boolean|Boolean]]<br />
|-<br />
| JettisonGoods(Menge, WarenTyp) || [[API:Integer|Integer]], [[API:EGoodsType|EGoodsType]]<br />
|-<br />
| LeaveAllFleets() || - <br />
|-<br />
| LeaveOrbit() || - <br />
|-<br />
| RefillWarpCore(Menge) || [[API:Integer|Integer]]<br />
|-<br />
| Repair(ShipID, Hüllenpunkte) || [[API:Integer|Integer]], [[API:Integer|Integer]]<br />
|-<br />
| SetAlertLevel(Stufe) || [[API:EAlertLevel|EAlertLevel]]<br />
|-<br />
| SetName(Name) || [[API:String|String]]<br />
|-<br />
| TransferFromColony(FromColonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| TransferFromShip(FromShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| TransferToColony(ToColonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| TransferToShip(ToShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| Undock() || -<br />
|-<br />
| colspan="3" | Weitere Erklärungen folgen...<br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=API:BooleanAPI:Boolean2010-08-20T01:52:46Z<p>Arakis: </p>
<hr />
<div>{{Vorlage:ApiMenu}}<br />
[[API:Boolean|Boolean]] ist ein Variablentyp. Jede Variable hat einen "Typ", darunter versteht man was für Daten in ihr gespeichert sind. <br />
<br />
Bei Boolean kommen nur zwei Werte in Frage - [[code|True]] oder [[code|False]] (umgangssprachlich 0 oder 1). <br />
Falls ein Paramater als [[API:Boolean|Boolean]] erwartet wird, bedeutet dies, dass man einfach True oder False (ohne Anführungsstriche) angeben muss.<br />
<br />
<br />
<br />
Desweiteren gibt es die Struktur Boolean http://game.stne.net/ObjectExplorer.aspx?p=Boolean :<br />
<br />
{|<br />
! Methode !! Erklärung<br />
|-<br />
| CompareTo(value AS Object)<br />
|-<br />
| FalseString<br />
|-<br />
| GetTypeCode()<br />
|-<br />
| Parse(s As String) || Diese Methode wandelt einen String in einen Integer-Wert um und gibt diesen zurück.<br />
|-<br />
| TrueString<br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=API:CMyShipAPI:CMyShip2010-08-20T01:50:05Z<p>Arakis: </p>
<hr />
<div>{{Vorlage:ApiMenu}}<br />
{{Code|CMyShip}} ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].<br />
<br />
Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.<br />
<br />
{{Code|Var Schiff As New CMyShip(123456);}}<br />
<br />
Nun ist in der Variable Schiff eine Instanz des Objektes [[API:CMyShip|CMyShip]] gespeichert.<br />
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:<br />
<br />
{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}<br />
<br />
Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] mit Hilfe der Methode Schiff.Action möglich.<br />
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.<br />
<br />
<br />
Beispiel:<br />
<br />
{{Code|Schiff.Action.ActivateSRS(True);}}<br />
<br />
<br />
Die am häufigsten benutzten Eigenschaften oder Methoden sind die folgenden:<br />
<br />
*Action ---> [[CBaseShipManager]]<br />
*Energy ---> gibt eine Zahl zurück<br />
*Docked ---> gibt True/False zurück<br />
*FlightRange ---> gibt die Anzahl der geflogenen Felder (Tick) zurück<br />
*Name <br />
*StockRoom --> Gibt dir eine Instanz der Klasse [API:|SStockRoom] zurück, mit denen du die aktueleln Waren im Lager etc. auslesen kannst<br />
*SRS ---> Gibt eine Instanz der Klasse [[API:CShipList|CShipList]] mit sämtlichen Schiffen im SRS zurück<br />
*WarpCore --> Wert des Warpkerns<br />
<br />
Eine vollständige Liste findest du direkt im Objektexplorer unter (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip)<br />
<br />
Mit denen ist es möglich, Informationen über das Schiff abfragen zu lassen und anschließend zum Beispiel den Warpkern auffüllen zu lassen:<br />
<br />
<br />
Var Schiff As CMyShip(12345);<br />
If (Schiff.WarpCore < 100) {<br />
If (Schiff.Docked = False) { <br />
Schiff.Action.DockTo(54321);<br />
}<br />
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Deuterium);<br />
Schiff.Action.TransferFromShip(54321, 10, EBeamResource.Antimatter);<br />
Schiff.Action.TransferFromShip(54321, 5, EBeamResource.Dilicium);<br />
Schiff.Action.RefilWarpCore(10);<br />
}<br />
WriteLine("Der Wert des Warpkerns beträgt nun: " & Schiff.WarpCore & " Einheiten");<br />
<br />
<br />
<br />
''Merke: Du kannst nur Instanzen von [[API:CMyShip|CMyShip]] mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.<br />
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste mit Hilfe von Schiff.SRS dir Instanzen von CShip mit einem "fremden" Schiff übergibt.''</div>Arakishttps://wiki.stne.net/index.php?title=API:CBaseShipManagerAPI:CBaseShipManager2010-08-20T01:49:40Z<p>Arakis: </p>
<hr />
<div>{{Vorlage:ApiMenu}}<br />
Die Klasse [[API:CBaseShipManager|CBaseShipManger]] wird benötigt um Aktionen mit einem Schiff durchzuführen.<br />
<br />
Hierzu ist es erstmal notwendig, eine Instanz von [[API:CMyShip|CMyShip]] zu erzeugen:<br />
<br />
[[code|Var Schiff As New CMyShip(123456);]]<br />
<br />
Auf das Schiff mit der NCC 123456 kann man nun sämtliche Methoden des Objektes [[API:CBaseShipManager|CBaseShipManger]] anwenden, da die Eigenschaft [[code|Action]] von [[API:CMyShip|CMyShip]] der Klasse [[API:CBaseShipManager|CBaseShipManager]] entspricht.<br />
<br />
Hier ein kleines Beispiel:<br />
<br />
Var Schiff As New CMyShip(123456);<br />
Var Station As New CMyShip(54321);<br />
<br />
Schiff.Action.CollectOre(20);<br />
Schiff.Action.FlyTo("150|250");<br />
Schiff.Action.EnterOrbit();<br />
Schiff.Action.DockTo(Station.ShipID);<br />
Schiff.Action.TransferToShip(Station.ShipID, 100, EBeamResource.IridiumOre);<br />
Schiff.Action.TransferFromShip(Station.ShipID, 50, EBeamResource.Deuterium);<br />
Schiff.Action.TransferFromShip(54321, 50, EBeamRessource.Food);<br />
Schiff.Action.Undock();<br />
Schiff.Action.LeaveOrbit();<br />
Schiff.Action.FlyTo("152|251");<br />
<br />
In dem Beispiel würde das eigene Schiff die vorgegeben Aktionen ausführen, in dem Fall: Erz sammeln, zu einer Station in einem tiefen Orbit fliegen, Andocken, Erz rüberbeamen, Schiff mit Nahrung sowie Deuterium versorgen und anschließend zurück fliegen.<br />
<br />
Hier eine Liste der gebräuchlichen Methoden von [[API:CBaseShipManager:CBaseShipManager]]:<br />
<br />
''Bitte beachte: Die Aktionen unterliegen den selben Einschränkungen wie im Spiel, d.h. du kannst nur mit anderen Schiffen interagieren, wenn sie im selben Sektor sind oder zum Beispiel auch nur die Schilde laden, wenn sie auch abgekühlt sind.''<br />
<br />
<br />
{|<br />
|-<br />
!Methode !! Parameter !! Erklärung<br />
|-<br />
|ActivateLRS(Status) || [[API:Boolean|Boolean]] || Bei Schiff.Action.ActivateLRS(True) wird das LRS aktiviert, bei "False" deaktiviert<br />
|-<br />
|ActivateReplicators(Status) || [[API:Boolean|Boolean]] || Aktiviert/Deaktiviert den Replikator an Bord<br />
|-<br />
|ActivateShields(Status) || [[API:Boolean|Boolean]] || Schilde aktivieren<br />
|-<br />
|ActivateSRS(Status) || [[API:Boolean|Boolean]] || SRS aktivieren<br />
|-<br />
|ActivateTractorBeam(ShipID) || [[API:Integer|Integer]] || Erfasst das Schiff mit der NCC-Nr "ShipID" im Traktorstrahl<br />
|-<br />
|ActivateWarpCore(Status) || [[API:Boolean|Boolean]] || Warpkern aktivieren<br />
|-<br />
|ApplyGoodsToConstruction() || - || Speißt beim Umbau von Tugs / Stationen die Waren ein<br />
|-<br />
|ChargeEmergencyBattery(ShipID, Menge) || [[API:Integer|Integer]], [[API:Integer|Integer]] || Lädt die Reservebatterie von dem Schiff mit der NCC-Nr "ShipID" um "Menge" Energieeinheiten<br />
|-<br />
|ChargeShields(Menge) || [[API:Integer|Integer]] || Lädt die eigenen Schilde um "Menge" auf.<br />
|-<br />
|CollectDeuterium(Energie) || [[API:Integer|Integer]] || Sammelt mit "Energie" Einheiten Deuterium<br />
|-<br />
|CollectOre(Energie) || [[API:Integer|Integer]] || Extrahiert mit "Energie" Einheiten Erz<br />
|-<br />
|DeactivateTractorBeam() || - || Deaktiviert den Traktorstrahl, in dem ein andere Schiff gehalten wird.<br />
|-<br />
|DischargeEmergencyBattery(Menge) || [[API:Integer|Integer]] || Entlädt die Reservebatterie um "Menge"<br />
|-<br />
|DockTo(ShipID) || [[API:Integer|Integer]] || Dockt an das Schiff/Station mit der NCC-Nr "ShipID" an<br />
|-<br />
|EnterOrbit || - || Betritt den Orbit der Kolonie, über der das Schiff gerade steht<br />
|-<br />
| ExtractFromWreck(Menge) || [[API:Integer|Integer]]<br />
|-<br />
| Fly(AnzahlFelder, Richtung) || [[API:Integer|Integer]], [[API:EShipDirection|EShipDirection]]<br />
|- <br />
| FlyTo(Position) || [[API:String|String]]<br />
|-<br />
| Hide(Versteckt) || [[API:Boolean|Boolean]]<br />
|-<br />
| JettisonGoods(Menge, WarenTyp) || [[API:Integer|Integer]], [[API:EGoodsType|EGoodsType]]<br />
|-<br />
| LeaveAllFleets() || - <br />
|-<br />
| LeaveOrbit() || - <br />
|-<br />
| RefillWarpCore(Menge) || [[API:Integer|Integer]]<br />
|-<br />
| Repair(ShipID, Hüllenpunkte) || [[API:Integer|Integer]], [[API:Integer|Integer]]<br />
|-<br />
| SetAlertLevel(Stufe) || [[API:EAlertLevel|EAlertLevel]]<br />
|-<br />
| SetName(Name) || [[API:String|String]]<br />
|-<br />
| TransferFromColony(FromColonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| TransferFromShip(FromShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| TransferToColony(ToColonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| TransferToShip(ToShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]]<br />
|-<br />
| Undock() || -<br />
|-<br />
| colspan="3" | Weitere Erklärungen folgen...<br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=API:BooleanAPI:Boolean2010-08-20T01:49:26Z<p>Arakis: </p>
<hr />
<div>{{Vorlage:ApiMenu}}<br />
[[API:Boolean|Boolean]] ist ein Variablentyp. Jede Variable hat einen "Typ", darunter versteht man was für Daten in ihr gespeichert sind. <br />
<br />
Bei Boolean kommen nur zwei Werte in Frage - [[code|True]] oder [[code|False]] (umgangssprachlich 0 oder 1). <br />
Falls ein Paramater als [[API:Bollean|Boolean]] erwartet wird, bedeutet dies, dass man einfach True oder False (ohne Anführungsstriche) angeben muss.<br />
<br />
<br />
<br />
Desweiteren gibt es die Struktur Boolean http://game.stne.net/ObjectExplorer.aspx?p=Boolean :<br />
<br />
{|<br />
! Methode !! Erklärung<br />
|-<br />
| CompareTo(value AS Object)<br />
|-<br />
| FalseString<br />
|-<br />
| GetTypeCode()<br />
|-<br />
| Parse(s As String) || Diese Methode wandelt einen String in einen Integer-Wert um und gibt diesen zurück.<br />
|-<br />
| TrueString<br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=Kategorie:APIKategorie:API2010-08-20T01:48:52Z<p>Arakis: Die Seite wurde neu angelegt: „Diese Kategorie listet die Klassen der Scriptengine auf.“</p>
<hr />
<div>Diese Kategorie listet die Klassen der Scriptengine auf.</div>Arakishttps://wiki.stne.net/index.php?title=API:IntegerAPI:Integer2010-08-20T01:48:19Z<p>Arakis: </p>
<hr />
<div>{{Vorlage:ApiMenu}}<br />
[[API:Integer|Integer]] ist ein Variablentyp. Jede Variable hat einen "Typ", darunter versteht man was für Daten in ihr gespeichert sind. <br />
<br />
Bei Integer sind es ganze Zahlen. Wenn irgendein Parameter als [[API:Integer|Integer]] angegeben werden muss, heißt das, die Funktion erwartet einfach eine Zahl.<br />
<br />
<br />
<br />
Desweiteren gibt es die Struktur Integer http://game.stne.net/ObjectExplorer.aspx?p=Integer :<br />
<br />
{|<br />
! Methode !! Erklärung<br />
|-<br />
| CompareTo(value AS Object)<br />
|-<br />
| GetTypeCode()<br />
|-<br />
| MaxValue<br />
|-<br />
| MinValue<br />
|-<br />
| Parse(s As String) || Diese Methode wandelt einen String in einen Integer-Wert um und gibt diesen zurück.<br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=Vorlage:ApiMenuVorlage:ApiMenu2010-08-20T01:47:22Z<p>Arakis: Die Seite wurde neu angelegt: „{| width="100%" | class="bc" | '''fertige Scripte''' | '''Anleitungen und FAQ''' | '''[[:Kategorie:Scriptin…“</p>
<hr />
<div>{| width="100%" <br />
| class="bc" | '''[[:Kategorie:Scripte|fertige Scripte]]''' | '''[[:Kategorie:Scripting-Hilfe|Anleitungen und FAQ]]''' | '''[[:Kategorie:Scripting|Überblick über die Scripting-Sektion]]''' | '''[[STNE-Wiki:Hilfe|Hilfen zum Arbeiten im Wiki]]''' <br />
|}<br />
[[Kategorie:API]]</div>Arakishttps://wiki.stne.net/index.php?title=Vorlage:ScriptingmenueVorlage:Scriptingmenue2010-08-20T01:45:11Z<p>Arakis: </p>
<hr />
<div>{| width="100%" <br />
| class="bc" | '''[[:Kategorie:Scripte|fertige Scripte]]''' | '''[[:Kategorie:Scripting-Hilfe|Anleitungen und FAQ]]''' | '''[[:Kategorie:Scripting|Überblick über die Scripting-Sektion]]''' | '''[[STNE-Wiki:Hilfe|Hilfen zum Arbeiten im Wiki]]''' <br />
|}<br />
[[Kategorie:Scripting]]</div>Arakishttps://wiki.stne.net/index.php?title=MediaWiki:SidebarMediaWiki:Sidebar2010-08-20T01:42:14Z<p>Arakis: </p>
<hr />
<div>* navigation<br />
** mainpage|mainpage<br />
** Inhalt|Inhaltsverzeichnis<br />
** Index|Von A bis Z<br />
** randompage-url|randompage<br />
<br />
* Mitmachen<br />
** helppage|help<br />
** portal-url|portal<br />
** recentchanges-url|recentchanges<br />
** currentevents-url|currentevents<br />
** Spenden|Spenden<br />
<br />
* Starflyer - Wikizeitung<br />
** News:Hauptseite|News-Start<br />
** News:Inhalt|Nachschlagen<br />
** Hilfe:News-Hilfe|Hilfe zum Mitschreiben<br />
<br />
* Script-Engine<br />
** Scripting:Hauptseite|Script-Start<br />
** Scripting:Inhalt|Nachschlagen<br />
** Kategorie:API|API Referenz</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:HauptseiteScripting:Hauptseite2010-08-19T21:28:32Z<p>Arakis: </p>
<hr />
<div>__NOTOC__<br />
__NOEDITSECTION__<br />
{{Scriptingmenue}}<br />
<br><br />
{| width="100%"<br />
|-<br />
| style="vertical-align:top; border-width:0px; width:100%" |<br />
<div style="margin:0; margin-right:10px;border:2px solid #16344E;"><br />
<br />
<!-- 1. Abschnitt oben Anfang --><br />
<div style="padding:0.3em 2.5em 0.7em 1em;"><br />
== Willkommen im Scripting-Teil des STNE-Wiki ==<br />
<br />
{| width="100%" cellpadding="10px"<br />
| class="nl" width="100%" valign="top" |<br />
Willkommen im Scripting-Teil des STNE-Wiki. Hier könnt ihr eigene Scripte veröffentlichen, Anleitungen schreiben oder einfach Beschreibungen zu Variablen, Konstanten und Funktionen ablegen. Weitere Informationen und Hilfe bekommt ihr im [http://forum.stne.net/index.php?c=34 Forum].<br />
<br />
|}<br />
</div><br />
<br />
<!-- 1. Abschnitt oben Ende --><br />
</div><br />
|}<small> <br></small><br />
{| width="100%"<br />
|-<br />
| style="vertical-align:top; border-width:0px; width:40%;" |<br />
<div style="margin:0; margin-right:10px;border:2px solid #16344E;"><br />
<br />
<!-- 2. Abschnitt (unten-links) Anfang --><br />
<div style="padding:0.3em 1em 0.7em 1em;"><br />
<br />
== neue Artikel ==<br />
Jeder kann hier mitmachen. Alles was du dafür benötigst sind ein registrierter Wiki-Account und entsprechende Kenntnisse im Scripten. Bitte ordent eure Artikel immer einer "sprechenden" Kategorie zu. So ist es später leichter, alles wieder zu finden.<br><br><br />
Gib hier den Titel des neuen Artikels ein: <br><br />
{{Vorlage:Neuen_Script-Artikel_eintragen}}<br />
<small>'''Gib den Titel für den neuen Artikel z.B. wie folgt an:<br><br />
Scripting:Funktion xyz '''</small><br />
</div><br />
<!-- 2. Abschnitt (unten-links) Ende --><br />
</div><br />
<br />
| style="vertical-align:top; border-width:0px; width:60%;" |<br />
<div style="margin:0; margin-right:10px;border:2px solid #16344E;"><br />
<br />
<!-- 3. Abschnitt (unten-mitte) Anfang --><br />
<div style="padding:0.3em 1em 0.7em 1em;"><br />
<br />
== fertige Artikel ==<br />
<div style="float:right;">[{{SERVER}}{{localurl:Vorlage:AktuellenScript-Artikel|action=edit}} '''„Fertigen&nbsp;Artikel“ hinzufügen''']</div><div style="clear:both;"><br />
</div><br />
{{AktuellenScript-Artikel}}<br />
<!-- 3. Abschnitt (unten-mitte) Ende --><br />
</div><br />
</div><br />
<br />
|-<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting]]</div>Arakishttps://wiki.stne.net/index.php?title=HauptseiteHauptseite2010-08-19T21:27:05Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
<br />
{| width="100%"<br />
|-<br />
| width="80%" style="vertical-align:top; border-width:0px"|<br />
<div style="margin:0; margin-right:10px;border:2px solid #16344E;"><br />
<br />
<!-- Begrüßung - 1. Abschnitt links Anfang --><br />
<div style="padding:0.3em 1em 0.7em 1em;"><br />
=='''Willkommen im STNE-Wiki'''==<br />
Willkommen in der Enzyklopädie von STNE. Hier findet ihr Hilfe zu allen Themen rund um STNE, könnt euch, eure Völker, Allianzen und Geschichten veröffentlichen. <br />
</div><br />
<!-- Navigationsleiste Themen --><br />
<div style="text-align:center; padding:7px 0px 4px 0px; border:0px solid #16344E; border-width:1px 0px 0px 0px;"><big>'''[http://game.stne.net/ STNE - Das Spiel] · [http://forum.stne.net/ STNE-Forum] <br> [[STNE-Team-Liste]] · [[News:Hauptseite|Wiki-Zeitung]]'''</big> </div><br />
</div><br />
<!-- Begrüßung - 1. Abschnitt links Ende --><br />
<!-- unsichtbar - 2. Abschnitt links Anfang <br />
<div style="margin:10px 10px 0px 0px; border:2px solid #dfdfdf; padding:0.6em; "><br />
'''Wiki-News'''<br />
textetxt<br />
</div> <br />
</div><br />
unsichtbar - 2. Abschnitt links Ende--><br />
<!-- Wie benutze ich ... - 3. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #16344E; padding:0em 1em 1em 1em; "><br />
<br />
== '''Schnellstart''' ==<br />
* '''[[Bugs|Übersicht aktueller Bugs]]'''<br />
* '''[[STNE2|Änderungen in STNE 2]]'''<br />
* [[Inhalt|Inhaltsverzeichnis]]<br />
* [[Index|Von A bis Z]]<br />
* [[Abkürzungsverzeichnis]]<br />
* [[:Kategorie:Allgemeines|thematische Suche]]<br />
* [[Hilfe:Cattree|Themenbaum]]<br />
* [[Spezial:Specialpages|Suchen in speziellen Seiten]]<br />
* [[Spezial:Search|Wiki-Suchfunktion]]<br />
* [http://www.google.de/custom?sa=Google+Search&domains=wiki.stne.net&sitesearch=wiki.stne.net Googlesuche im STNE-Wiki]<br />
<div align="right"><small>'''mehr über [[Hilfe:Suche|suchen im Wiki]]... ''' </small></div><br />
</div><br />
<!-- Wie benutze ich ... - 3. Abschnitt links Ende --><br />
<!-- Wichtige Links - 4. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #16344E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Schon gewußt, dass ...'''==<br />
{{HS-Doyouknow}}<br />
</div><br />
<!-- Wichtige Links - 4. Abschnitt links Ende --><br />
<!-- News - 5. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #16344E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Wiki-News''' ==<br />
{{HS-News}}<br />
</div><br />
<!-- News - 5. Abschnitt links Ende --><br />
<!-- RECHTE SPALTE --><br />
<!-- Logo - 1. Abschnitt rechts Anfang --><br />
| width="48%" style="vertical-align:top; border-width:0px" |<br />
<div style="margin:0; border:2px solid gold padding:0em 1em 1em 1em;"><br />
<center>[[Bild:warp5.jpg]]</center><br />
</div><br />
<!-- Logo - 1. Abschnitt rechts Ende --><br />
<!-- Schnellstart - 2. Abschnitt rechts Anfang --><br />
<div style="margin:0; margin-top:10px; border:2px solid #16344E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Hilfe zum STNE-Wiki?''' ==<br />
Hilfe zum STNE-Wiki findet ihr hier:<br />
* [[STNE-Wiki:Hilfe|STNE-Wiki-Hilfe]]<br />
* im [[IRC]] im Channel #wiki<br />
* einen Admin aus dieser [[STNE-Wiki:Administratoren|Liste]] ingame anschreiben<br />
* [http://wiki.stne.net/index.php?title=Hilfe:Fragen_zum_STNE-Wiki&action=edit&section=new ...oder stelle deine Frage hier]<br />
</div><br />
<!-- Schnellstart - 2. Abschnitt rechts Ende --><br />
<!-- Wiki-Mitarbeit - 3. Abschnitt rechts Anfang --><br />
<div style="margin:0; margin-top:10px; border:2px solid #16344E; padding:0em 1em 1em 1em; margin-top:10px;"><br />
<br />
== '''Wiki-Mitarbeit''' ==<br />
Jeder im Wiki angemeldete Spieler kann am Wiki mit arbeiten. Alles was ihr dazu braucht ist ein wenig Zeit und etwas Wissen, dass ihr mit anderen teilen wollt.<br />
Ebenso warten noch viele Einzelseiten auf einen Inhalt. Ihr findet diese Seiten [[Spezial:Wantedpages|hier]].<br />
Auch viele der bereits vorhandenen Seiten warten auf Ergänzungen oder Korrekturen. Schaut einfach mal rein !<br />
<br><br />
Hilfreiche Links zum Thema Wiki-Mitarbeit findet ihr hier:<br />
* [[STNE-Wiki:Hilfe|STNE-Wiki-Hilfe]]<br />
* [http://de.wikipedia.org/wiki/Wikipedia:Erste_Schritte erste Schritte im Wiki]<br />
* [http://de.wikipedia.org/wiki/Wikipedia:Handbuch Benutzerhandbuch]<br><br><br />
Bitte tragt auf jeder Seite ganz oben <nowiki>{{menue}}</nowiki> und ganz unten <nowiki>[[Kategorie:kategoriename]]</nowiki> ein. <br><br />
<div align="right"><small>'''mehr über [[Wiki-Mitarbeit]]'''</small></div><br />
</div><br />
<!-- Wiki-Mitarbeit - 3. Abschnitt rechts Ende --><br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=API:CMyShipAPI:CMyShip2010-08-19T20:34:54Z<p>Arakis: </p>
<hr />
<div>CMyShip ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].<br />
<br />
Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.<br />
<br />
<br />
{{Code|Var Schiff As New CMyShip(123456);}}<br />
<br />
<br />
Nun ist in der Variable Schiff eine Instanz des Objektes CMyShip gespeichert.<br />
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:<br />
<br />
<br />
<br />
{{Code|WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");}}<br />
<br />
<br />
Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] möglich.<br />
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.<br />
<br />
<br />
Beispiel:<br />
<br />
<br />
{{Code|Schiff.Action.ActivateSRS(True);}}<br />
<br />
<br />
''Merke: Du kannst nur Instanzen von CMyShip mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.<br />
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste dir eine Instanz von CShip mit einem "fremden" Schiff übergibt.''</div>Arakishttps://wiki.stne.net/index.php?title=Vorlage:CodeVorlage:Code2010-08-19T20:33:45Z<p>Arakis: </p>
<hr />
<div><noinclude>Use this template for small pieces of in-line code. Use pre tags for multi-line code.<br />
<br />
Usage:<br />
<pre>{{code|Function DoStuff()}}</pre><br />
<br />
Result:<br />
{{code|Function DoStuff()}}<br />
<br />
</noinclude><includeonly><span style="font-family:monospace; color:#FFFFFF;">{{{1}}}</span></includeonly></div>Arakishttps://wiki.stne.net/index.php?title=API:CMyShipAPI:CMyShip2010-08-19T20:31:49Z<p>Arakis: </p>
<hr />
<div>CMyShip ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].<br />
<br />
Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.<br />
<br />
<br />
::Var Schiff As New CMyShip(123456);<br />
<br />
<br />
Nun ist in der Variable Schiff eine Instanz des Objektes CMyShip gespeichert.<br />
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:<br />
<br />
<br />
<br />
::WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");<br />
<br />
<br />
Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] möglich.<br />
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.<br />
<br />
<br />
Beispiel:<br />
<br />
<br />
::Schiff.Action.ActivateSRS(True);<br />
<br />
<br />
''Merke: Du kannst nur Instanzen von CMyShip mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[API:CShip|CShip]] handhaben aber nicht via der NCC-Nummer erstellen.<br />
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste dir eine Instanz von CShip mit einem "fremden" Schiff übergibt.''</div>Arakishttps://wiki.stne.net/index.php?title=API:CMyShipAPI:CMyShip2010-08-19T20:31:25Z<p>Arakis: </p>
<hr />
<div>CMyShip ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip|CShip]].<br />
<br />
Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.<br />
<br />
<br />
::Var Schiff As New CMyShip(123456);<br />
<br />
<br />
Nun ist in der Variable Schiff eine Instanz des Objektes CMyShip gespeichert.<br />
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:<br />
<br />
<br />
<br />
::WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");<br />
<br />
<br />
Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager|CBaseShipManager]] möglich.<br />
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.<br />
<br />
<br />
Beispiel:<br />
<br />
<br />
::Schiff.Action.ActivateSRS(True);<br />
<br />
<br />
''Merke: Du kannst nur Instanzen von CMyShip mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[CShip]] handhaben aber nicht via der NCC-Nummer erstellen.<br />
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste dir eine Instanz von CShip mit einem "fremden" Schiff übergibt.''</div>Arakishttps://wiki.stne.net/index.php?title=API:CMyShipAPI:CMyShip2010-08-19T20:30:56Z<p>Arakis: </p>
<hr />
<div>CMyShip ist so ziemlich die wichtigste Klasse in der ScriptEngine. Sie erbt die kompletten Eigenschaften von [[API:CShip]].<br />
<br />
Zum Verständnis ein kurzes Beispiel, in dem es sich um ein eigenes Schiff mit der NCC-Nummer 123456 handelt.<br />
<br />
<br />
::Var Schiff As New CMyShip(123456);<br />
<br />
<br />
Nun ist in der Variable Schiff eine Instanz des Objektes CMyShip gespeichert.<br />
Ein Blick auf den Objektexplorer (http://game.stne.net/ObjectExplorer.aspx?p=CMyShip) verrät dir, was du damit anstellen kannst:<br />
<br />
<br />
<br />
::WriteLine(Schiff.Name & " hat momentan " & Schiff.Energy & " Energie");<br />
<br />
<br />
Desweiteren sind natürlich auch Aktionen über das Objekt [[API:CBaseShipManager]] möglich.<br />
Genauere Informationen hierzu findest du bei der Objekt-Dokumentation.<br />
<br />
<br />
Beispiel:<br />
<br />
<br />
::Schiff.Action.ActivateSRS(True);<br />
<br />
<br />
''Merke: Du kannst nur Instanzen von CMyShip mit deinen eigenen Schiffen erstellen, andere Schiffe kannst du nur via [[CShip]] handhaben aber nicht via der NCC-Nummer erstellen.<br />
Du kannst nur mit ihnen Arbeiten, wenn dir eine Funktion z.B. die Auswertung der SRS-Liste dir eine Instanz von CShip mit einem "fremden" Schiff übergibt.''</div>Arakishttps://wiki.stne.net/index.php?title=PolaronkraftwerkPolaronkraftwerk2010-08-03T23:25:24Z<p>Arakis: </p>
<hr />
<div>{{Menue}}<br />
{| border="1" cellspacing="0" style="float:right;margin-left:0.5em"<br />
!| Polaronkraftwerk<br />
|-<br />
| align="center" | http://game2.stne.net/i/m/4/42/0.gif http://game2.stne.net/i/m/5/42/0.gif http://game2.stne.net/i/m/10/42/0.gif<br><br />
|-<br />
!|[[Untergrund]]<br />
|-<br />
|<br />
* [[Eis]] <br><br />
* [[Wüste]] <br><br />
* [[Gestein]] <br><br />
<br />
|-<br />
!|Notwendiges Kolo-Level<br />
|-<br />
| align="center" | 8+<br />
|-<br />
!|Notwendige Forschung<br />
|-<br />
| align="center" |[[Polaron-Kraftwerk-Konstruktion]]<br />
|-<br />
!|Integrität / Panzerung<br />
|-<br />
| align="center" | 300 / 6<br />
|-<br />
!|Baukosten<br />
|-<br />
|<br />
* 100 [[Energie]] <br><br />
* 200 [[Baumaterial]] <br><br />
* 200 [[Duranium]] <br><br />
|-<br />
!|Dauerkosten<br />
|-<br />
|<br />
* 6 [[Leute]] <br><br />
|-<br />
!|Dauereffekt<br />
|-<br />
| align="center" | 60 [[Energie]]<br><br />
-20 [[Internes Ansehen]]<br><br />
|-<br />
!|Bauzeit<br />
|-<br />
| align="center" | 20 [[Ticks|Runden]]<br />
|} <br />
<br />
<br><br />
<br><br />
<br />
Ein <B>Polar</B>(ische I)<B>on</B>(en)<B>-Kraftwerk</B> macht sich die Polaron-Strahlung zu Nutze, um 60 Energie pro Tick zu erzeugen. '''Jede Runde besteht allerdings auch eine 0,2-prozentige Chance, dass das Polaronkraftwerk explodiert.''' Dabei werden alle 8 Einrichtungen rund um das Kraftwerk mit je 60 Punkten beschädigt und alle 16 Einrichtungen im Radius von 2 Feldern um das Kraftwerk mit je 30 Schadenspunkten.<br><br />
<br><br />
Wenn ein Polaronkraftwerk explodiert, ist die Kolonie für 35 Ticks "<B>unbesiedelt</B>", unabhängig davon, wo welches Gebäude stand. Die entstehende Polaronwolke verliert jede Runde an Stärke. Nach einer Woche (35 Ticks) kann die Kolonie wieder besiedelt werden. Desweiteren flieht sämtliche Crew von Schiffen im Orbit, dessen Schilde nicht aktiviert sind.<br /><br /><br />
<br />
<BR><br />
Seit dem berühmten Unfall auf der romulanischen Forschungsbasis <I>Chaltok IV</I> sind Polaronkraftwerke interstellar <B>geächtete Einrichtungen</B>. Sie sind äußerst gefährlich und beschädigen bei ihrer Explosion den Subraum. Leider ist der Einsatz dieses Kraftwerkstyps bei der Bevölkerung auf Grund der damit verbunden Risiken nicht sehr beliebt und führt zu einem Verlust von 20 internen Ansehenspunkten pro Tick.<br><br />
<br><br><br />
<br><br><br />
{{seealso}}<br />
* [[Polaron-Kraftwerk-Konstruktion]] (Forschung)<br><br />
* [[Polaron-Forschung]] (Forschung)<br><br />
* [[Warpkern]] (Gebäude)<br><br />
* [[Geothermales Kraftwerk]] (Gebäude)<br><br />
* [[Strahlungssammler]] (Gebäude)<br><br />
* [[Fusionsreaktor]] (Gebäude)<br><br />
* [[Strömungsturbinen]] (Gebäude)<br><br />
* [[Solarsatellit]] (Gebäude)<br><br />
* [[Solarkomplex]] (Gebäude)<br><br />
* [[Solarzellen]] (Gebäude)<br><br />
* [[Gebäude]]<br />
<br><br />
<br><br />
[[Kategorie:Gebäude]]<br />
[[Kategorie:zu erforschende Gebäude]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2009-03-15T14:55:05Z<p>Arakis: /* Methoden */ Klammern bei Return nicht notwendig!</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>WriteLine('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>WriteLine('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von mehreren Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - Zeichenketten<br />
* Integer - Zahlen<br />
* Boolean - Entscheidungen (<tt>Ja/Nein; Wahr/Falsch; True/False</tt>)<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''VAR'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. Optional danach kann ein ''AS'' stehen (as, engl., als) dieses gibt an was für einen Datentyp die Variable hat, zb. String also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>VAR i1 AS String</pre><br />
Um dieser Variable einen Inhalt zuzuordnen, schreibt man in der nächsten Zeile die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt, den die Variable annehmen soll, in unserem nächsten Beispiel ein <i>Hallo!</i>.<br />
<pre>Var test AS String<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>VAR test AS String = 'Hallo!'</pre><br />
Auch hier müssen wir wieder die einfachen Anführungszeichen setzen, als Kennzeichen dafür, dass wir einen String als Inhalt benutzen. Wir können Variablen aber auch andere Datentypen wie Integer oder Bolean zuweisen. Dazu einfach string durch den jeweiligen Datetyp ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hierzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>VAR test AS String = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
VAR test AS String = 'Hallo!'<br />
WriteLine( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeichen eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur, dass sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
VAR test AS String = 'Hallo!'<br />
WriteLine(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable, also eine Zahl, ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet ein Integer intern anders als ein String. Ein String kann er ausgeben ein Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
WriteLine(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
* Niemals reservierte Namen benutzen! Dazu Zählen u.a. alle Datumsangaben, wie <tt>Date</tt>, <tt>Minute</tt>, <tt>Day</tt> etc.; jegliche Befehle und vom Systemvorgegebenen Funktionsnamen und Eigenschaften wie: <tt>Flotte</tt>, <tt>BenutzeSchiff</tt>, <tt>Nahrung</tt>, <tt>FliegeZu</tt> etc.<br />
* Man sollte der Übersicht wegen die Variablen immer (Richtlinie) mit drei Buchstaben beginnen lassen, welche beschreiben, welches Datenformat die Variable hat (z.B.: <tt>strVariablenName</tt> für ein String, <tt>IntVariablenName</tt> für ein Integer etc.)<br />
* Man sollte immer die gleichen Namensrichtlinien einsetzen, damit man bei älteren Scripten noch den Durchblick behält<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
* Eine Variable ist ein Platzhalter für einen variablen Inhalt eines festgelegten Datentypen.<br />
* Um eine Variable zu erstellen wird ''VAR <b>Name</b> AS <b>Datentyp</b>;'' verwendet.<br />
* Um einer Variablen einen Inhalt zu zuweisen wird ''<b>Name</b> = <b>Inhalt</b>;'' verwendet.<br />
* Um eine Variable auszugeben oder mit ihr zu arbeiten, wird der Name geschrieben zB: ''WriteLine(<b>Name</b>);''<br />
* Es ist möglich mehrere Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''WriteLine();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden 2 Variablen miteinander verglichen oder überprüft, ob eine Variable einem Wert entspricht und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 = 42)<br />
{<br />
WriteLine('var1 ist 42');<br />
}<br />
else<br />
{<br />
WriteLine('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 42)</nowiki></pre><br />
Hier wird der Vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgeführt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
WriteLine('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
WriteLine('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
WriteLine('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
WriteLine('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
WriteLine(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
WriteLine('Ich zähle jetzt bis Null');<br />
Do<br />
{<br />
WriteLine(CStr(i));<br />
i = i -1;<br />
}<br />
While (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
WriteLine(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
WriteLine(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>ShipManager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>ShipManager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der ShipManager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
Syntaxe:<br />
ShipManager.TransferiereZuSchiff(''Schiffid'', ''Menge'', EBeamRessource.''Ware'');<br />
Hier musst du nun nurnoch den kursiven Text mit deinen Angaben ersetzten. Hier ein Beispiele:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.TransferiereZuSchiff(2, 20, EBeamRessource.Nahrung);<br />
Natürlich kann man auch eine ganze Flotte beamen lassen, dazu ersetzt du ''ShipManager.BenutzteSchiff(1);'' durch ''ShipManager.BenutzteFlotte(1);'' Dann sieht das Script folgendermasen aus:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.TransferiereZuSchiff(2, 20, EBeamRessource.Nahrung);<br />
<br />
===Fliegen===<br />
Bei der Syntaxe gibt es 2 Möglichkeiten, die eine für Spieler unter Level 8 oder mit [[Feature-Pack]], also mit Autopilot, und die andere für die Leute über Level 8 und ohne Feature-Pack, die Variante ohne Autopilot.<br />
====Fliegen mit dem Autopiloten====<br />
<font color="red">'''''Nur für Spieler mit Feature-Pack oder unter Kolonisationslevel 8 möglich!'''''</font><br />
<br />
Der Befehl:<br />
ShipManager.FliegeZu(''xxx|yyy'');<br />
Auch hier Gilt es wieder das kursive durch die eigenen Angaben zu ersetzten. Wie in folgendem Beispiel:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.FliegeZu('123|465');<br />
oder mit dem Flottenbefehl:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.FliegeZu('123|465');<br />
Mit deisem Befehl fliegt das Schiff zu einer belibigen Position, [[NPC|NPC-Gebiete]] ausgenommen, und umgeht dabei wie der Autopilot Energie-intensive Hindernisse, sowie solche die das Schiff oder die Crew Gefährden.<br />
<br />
====Fliegen ohne Autopilot====<br />
Der Befehl hierzu sieht wie folgt aus:<br />
ShipManager.Fliege(''Strecke'', EShipRichtung.''Richtung'');<br />
Auch hier ersetzt du die kursiven Worte mit deinen Angaben, ein Beispiel folgt:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.Fliege(5, EShipRichtung.Hoch);<br />
ShipManager.Fliege(8, EshipRichtung.Links);<br />
oder wenn es eine ganze Flotte ist:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.Fliege(5, EShipRichtung.Hoch);<br />
ShipManager.Fliege(8, EshipRichtung.Links);<br />
<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
===Alternative zum Schiffsmanager: Schiffsaktion===<br />
<br />
Für Objekte des Typ's CMyFlotte und CMyShip kann über die Eigenschaft Aktion direkt auf die Funktionen des Schiffsmanagers zugegriffen werden.<br />
<br />
<pre><nowiki>VAR Schiff AS CMyShip = new CMyShip( 4711 )<br />
Schiff.Aktion.Abdocken()</nowiki></pre><br />
<br />
<pre><nowiki>VAR Flotte AS CMyFlotte = new CMyFlotte( 4711 )<br />
Flotte.Aktion.Abdocken()</nowiki></pre><br />
<br />
==Enumeration ist Alles==<br />
kommt noch<br />
<br />
==Methoden==<br />
<br />
Öfters wiederkehrende Aufgaben können in Methoden zusammengefasst werden:<br />
<pre><nowiki><br />
Function ShowKoords(x As Integer, y As Integer)<br />
{<br />
WriteLine(CStr(x) + '|' + CStr(y));<br />
}<br />
</nowiki></pre><br />
Die Methode ShowKoords kann dann im Script folgendermaßen aufgerufen werden:<br />
<pre><nowiki><br />
ShowKoords(3, 4);<br />
ShowKoords(ship.MapPosition.X,ship.MapPosition.Y);<br />
</nowiki></pre><br />
Wenn berechnete Werte von der Methode zurückgegeben werden sollen:<br />
<pre><nowiki><br />
Function Distanz(x1 As Integer, y1 As Integer, x2 As Integer, y2 As Integer) As Integer<br />
{<br />
Var distanz As Integer;<br />
<br />
distanz = Math.Abs(x1 - x2) + Math.Abs(y1 - y2);<br />
Return distanz ;<br />
}<br />
<br />
WriteLine(Distanz(1, 1, 5, 5));<br />
</nowiki></pre><br />
Einfache Typen werden immer 'ByVal' übergeben, d.h. die Werte werden als Kopie an die Methode übergeben und die entsprechenden Variablen im Script nicht verändert.<br />
'ByRef' ist zwar in der Scriptengine vorgesehen und kann angegeben werden, ist aber derzeit ohne Funktion.<br />
Objekte werden immer ByRef übergeben.<br />
<br />
==Klassen==<br />
<br />
In Klassen können Daten und Methoden in einem Objekt gekapselt werden:<br />
<br />
<pre><nowiki><br />
Class CKoords<br />
{<br />
Var x As Integer;<br />
Var y As Integer;<br />
<br />
Function New(x As Integer, y As Integer)<br />
{<br />
This.x = x;<br />
This.y = y;<br />
}<br />
<br />
Function ToString() As String<br />
{<br />
Return (CStr(x) + '|' + CStr(y);<br />
}<br />
<br />
Function Distanz(koord As CKoords) As Integer<br />
{<br />
Return Math.Abs(x - koord.x) + Math.Abs(y - koord.y);<br />
}<br />
}<br />
<br />
Var ko1 As New CKoords(3, 5);<br />
Var ko2 As CKoords;<br />
<br />
<br />
ko2 = New CKoords(8, 9);<br />
WriteLine('Distanz von ' + ko1.ToString() + ' nach ' + ko2.ToString() + ': ' + CStr(ko1.Distanz(ko2)));<br />
</nowiki></pre><br />
<br />
Wichtig: Klassen brauchen immer eine Methode New(), sonst kann kein neues Objekt der Klasse generiert werden!<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2, Kapitel 4<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung Kapitel 1<br />
|-<br />
|Fling<br />
|54865<br />
|Kapitel 7, Kapitel 8<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2009-03-15T14:54:21Z<p>Arakis: /* Klassen */</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>WriteLine('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>WriteLine('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von mehreren Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - Zeichenketten<br />
* Integer - Zahlen<br />
* Boolean - Entscheidungen (<tt>Ja/Nein; Wahr/Falsch; True/False</tt>)<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''VAR'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. Optional danach kann ein ''AS'' stehen (as, engl., als) dieses gibt an was für einen Datentyp die Variable hat, zb. String also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>VAR i1 AS String</pre><br />
Um dieser Variable einen Inhalt zuzuordnen, schreibt man in der nächsten Zeile die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt, den die Variable annehmen soll, in unserem nächsten Beispiel ein <i>Hallo!</i>.<br />
<pre>Var test AS String<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>VAR test AS String = 'Hallo!'</pre><br />
Auch hier müssen wir wieder die einfachen Anführungszeichen setzen, als Kennzeichen dafür, dass wir einen String als Inhalt benutzen. Wir können Variablen aber auch andere Datentypen wie Integer oder Bolean zuweisen. Dazu einfach string durch den jeweiligen Datetyp ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hierzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>VAR test AS String = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
VAR test AS String = 'Hallo!'<br />
WriteLine( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeichen eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur, dass sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
VAR test AS String = 'Hallo!'<br />
WriteLine(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable, also eine Zahl, ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet ein Integer intern anders als ein String. Ein String kann er ausgeben ein Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
WriteLine(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
* Niemals reservierte Namen benutzen! Dazu Zählen u.a. alle Datumsangaben, wie <tt>Date</tt>, <tt>Minute</tt>, <tt>Day</tt> etc.; jegliche Befehle und vom Systemvorgegebenen Funktionsnamen und Eigenschaften wie: <tt>Flotte</tt>, <tt>BenutzeSchiff</tt>, <tt>Nahrung</tt>, <tt>FliegeZu</tt> etc.<br />
* Man sollte der Übersicht wegen die Variablen immer (Richtlinie) mit drei Buchstaben beginnen lassen, welche beschreiben, welches Datenformat die Variable hat (z.B.: <tt>strVariablenName</tt> für ein String, <tt>IntVariablenName</tt> für ein Integer etc.)<br />
* Man sollte immer die gleichen Namensrichtlinien einsetzen, damit man bei älteren Scripten noch den Durchblick behält<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
* Eine Variable ist ein Platzhalter für einen variablen Inhalt eines festgelegten Datentypen.<br />
* Um eine Variable zu erstellen wird ''VAR <b>Name</b> AS <b>Datentyp</b>;'' verwendet.<br />
* Um einer Variablen einen Inhalt zu zuweisen wird ''<b>Name</b> = <b>Inhalt</b>;'' verwendet.<br />
* Um eine Variable auszugeben oder mit ihr zu arbeiten, wird der Name geschrieben zB: ''WriteLine(<b>Name</b>);''<br />
* Es ist möglich mehrere Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''WriteLine();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden 2 Variablen miteinander verglichen oder überprüft, ob eine Variable einem Wert entspricht und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 = 42)<br />
{<br />
WriteLine('var1 ist 42');<br />
}<br />
else<br />
{<br />
WriteLine('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 42)</nowiki></pre><br />
Hier wird der Vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgeführt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
WriteLine('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
WriteLine('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
WriteLine('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
WriteLine('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
WriteLine(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
WriteLine('Ich zähle jetzt bis Null');<br />
Do<br />
{<br />
WriteLine(CStr(i));<br />
i = i -1;<br />
}<br />
While (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
WriteLine(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
WriteLine(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>ShipManager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>ShipManager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der ShipManager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
Syntaxe:<br />
ShipManager.TransferiereZuSchiff(''Schiffid'', ''Menge'', EBeamRessource.''Ware'');<br />
Hier musst du nun nurnoch den kursiven Text mit deinen Angaben ersetzten. Hier ein Beispiele:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.TransferiereZuSchiff(2, 20, EBeamRessource.Nahrung);<br />
Natürlich kann man auch eine ganze Flotte beamen lassen, dazu ersetzt du ''ShipManager.BenutzteSchiff(1);'' durch ''ShipManager.BenutzteFlotte(1);'' Dann sieht das Script folgendermasen aus:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.TransferiereZuSchiff(2, 20, EBeamRessource.Nahrung);<br />
<br />
===Fliegen===<br />
Bei der Syntaxe gibt es 2 Möglichkeiten, die eine für Spieler unter Level 8 oder mit [[Feature-Pack]], also mit Autopilot, und die andere für die Leute über Level 8 und ohne Feature-Pack, die Variante ohne Autopilot.<br />
====Fliegen mit dem Autopiloten====<br />
<font color="red">'''''Nur für Spieler mit Feature-Pack oder unter Kolonisationslevel 8 möglich!'''''</font><br />
<br />
Der Befehl:<br />
ShipManager.FliegeZu(''xxx|yyy'');<br />
Auch hier Gilt es wieder das kursive durch die eigenen Angaben zu ersetzten. Wie in folgendem Beispiel:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.FliegeZu('123|465');<br />
oder mit dem Flottenbefehl:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.FliegeZu('123|465');<br />
Mit deisem Befehl fliegt das Schiff zu einer belibigen Position, [[NPC|NPC-Gebiete]] ausgenommen, und umgeht dabei wie der Autopilot Energie-intensive Hindernisse, sowie solche die das Schiff oder die Crew Gefährden.<br />
<br />
====Fliegen ohne Autopilot====<br />
Der Befehl hierzu sieht wie folgt aus:<br />
ShipManager.Fliege(''Strecke'', EShipRichtung.''Richtung'');<br />
Auch hier ersetzt du die kursiven Worte mit deinen Angaben, ein Beispiel folgt:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.Fliege(5, EShipRichtung.Hoch);<br />
ShipManager.Fliege(8, EshipRichtung.Links);<br />
oder wenn es eine ganze Flotte ist:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.Fliege(5, EShipRichtung.Hoch);<br />
ShipManager.Fliege(8, EshipRichtung.Links);<br />
<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
===Alternative zum Schiffsmanager: Schiffsaktion===<br />
<br />
Für Objekte des Typ's CMyFlotte und CMyShip kann über die Eigenschaft Aktion direkt auf die Funktionen des Schiffsmanagers zugegriffen werden.<br />
<br />
<pre><nowiki>VAR Schiff AS CMyShip = new CMyShip( 4711 )<br />
Schiff.Aktion.Abdocken()</nowiki></pre><br />
<br />
<pre><nowiki>VAR Flotte AS CMyFlotte = new CMyFlotte( 4711 )<br />
Flotte.Aktion.Abdocken()</nowiki></pre><br />
<br />
==Enumeration ist Alles==<br />
kommt noch<br />
<br />
==Methoden==<br />
<br />
Öfters wiederkehrende Aufgaben können in Methoden zusammengefasst werden:<br />
<pre><nowiki><br />
Function ShowKoords(x As Integer, y As Integer)<br />
{<br />
WriteLine(CStr(x) + '|' + CStr(y));<br />
}<br />
</nowiki></pre><br />
Die Methode ShowKoords kann dann im Script folgendermaßen aufgerufen werden:<br />
<pre><nowiki><br />
ShowKoords(3, 4);<br />
ShowKoords(ship.MapPosition.X,ship.MapPosition.Y);<br />
</nowiki></pre><br />
Wenn berechnete Werte von der Methode zurückgegeben werden sollen:<br />
<pre><nowiki><br />
Function Distanz(x1 As Integer, y1 As Integer, x2 As Integer, y2 As Integer) As Integer<br />
{<br />
Var distanz As Integer;<br />
<br />
distanz = Math.Abs(x1 - x2) + Math.Abs(y1 - y2);<br />
Return(distanz);<br />
}<br />
<br />
WriteLine(Distanz(1, 1, 5, 5));<br />
</nowiki></pre><br />
Einfache Typen werden immer 'ByVal' übergeben, d.h. die Werte werden als Kopie an die Methode übergeben und die entsprechenden Variablen im Script nicht verändert.<br />
'ByRef' ist zwar in der Scriptengine vorgesehen und kann angegeben werden, ist aber derzeit ohne Funktion.<br />
Objekte werden immer ByRef übergeben.<br />
<br />
==Klassen==<br />
<br />
In Klassen können Daten und Methoden in einem Objekt gekapselt werden:<br />
<br />
<pre><nowiki><br />
Class CKoords<br />
{<br />
Var x As Integer;<br />
Var y As Integer;<br />
<br />
Function New(x As Integer, y As Integer)<br />
{<br />
This.x = x;<br />
This.y = y;<br />
}<br />
<br />
Function ToString() As String<br />
{<br />
Return (CStr(x) + '|' + CStr(y);<br />
}<br />
<br />
Function Distanz(koord As CKoords) As Integer<br />
{<br />
Return Math.Abs(x - koord.x) + Math.Abs(y - koord.y);<br />
}<br />
}<br />
<br />
Var ko1 As New CKoords(3, 5);<br />
Var ko2 As CKoords;<br />
<br />
<br />
ko2 = New CKoords(8, 9);<br />
WriteLine('Distanz von ' + ko1.ToString() + ' nach ' + ko2.ToString() + ': ' + CStr(ko1.Distanz(ko2)));<br />
</nowiki></pre><br />
<br />
Wichtig: Klassen brauchen immer eine Methode New(), sonst kann kein neues Objekt der Klasse generiert werden!<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2, Kapitel 4<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung Kapitel 1<br />
|-<br />
|Fling<br />
|54865<br />
|Kapitel 7, Kapitel 8<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2009-03-15T14:54:02Z<p>Arakis: /* Klassen */</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>WriteLine('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>WriteLine('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von mehreren Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - Zeichenketten<br />
* Integer - Zahlen<br />
* Boolean - Entscheidungen (<tt>Ja/Nein; Wahr/Falsch; True/False</tt>)<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''VAR'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. Optional danach kann ein ''AS'' stehen (as, engl., als) dieses gibt an was für einen Datentyp die Variable hat, zb. String also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>VAR i1 AS String</pre><br />
Um dieser Variable einen Inhalt zuzuordnen, schreibt man in der nächsten Zeile die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt, den die Variable annehmen soll, in unserem nächsten Beispiel ein <i>Hallo!</i>.<br />
<pre>Var test AS String<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>VAR test AS String = 'Hallo!'</pre><br />
Auch hier müssen wir wieder die einfachen Anführungszeichen setzen, als Kennzeichen dafür, dass wir einen String als Inhalt benutzen. Wir können Variablen aber auch andere Datentypen wie Integer oder Bolean zuweisen. Dazu einfach string durch den jeweiligen Datetyp ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hierzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>VAR test AS String = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
VAR test AS String = 'Hallo!'<br />
WriteLine( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeichen eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur, dass sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
VAR test AS String = 'Hallo!'<br />
WriteLine(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable, also eine Zahl, ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet ein Integer intern anders als ein String. Ein String kann er ausgeben ein Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
WriteLine(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
* Niemals reservierte Namen benutzen! Dazu Zählen u.a. alle Datumsangaben, wie <tt>Date</tt>, <tt>Minute</tt>, <tt>Day</tt> etc.; jegliche Befehle und vom Systemvorgegebenen Funktionsnamen und Eigenschaften wie: <tt>Flotte</tt>, <tt>BenutzeSchiff</tt>, <tt>Nahrung</tt>, <tt>FliegeZu</tt> etc.<br />
* Man sollte der Übersicht wegen die Variablen immer (Richtlinie) mit drei Buchstaben beginnen lassen, welche beschreiben, welches Datenformat die Variable hat (z.B.: <tt>strVariablenName</tt> für ein String, <tt>IntVariablenName</tt> für ein Integer etc.)<br />
* Man sollte immer die gleichen Namensrichtlinien einsetzen, damit man bei älteren Scripten noch den Durchblick behält<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
* Eine Variable ist ein Platzhalter für einen variablen Inhalt eines festgelegten Datentypen.<br />
* Um eine Variable zu erstellen wird ''VAR <b>Name</b> AS <b>Datentyp</b>;'' verwendet.<br />
* Um einer Variablen einen Inhalt zu zuweisen wird ''<b>Name</b> = <b>Inhalt</b>;'' verwendet.<br />
* Um eine Variable auszugeben oder mit ihr zu arbeiten, wird der Name geschrieben zB: ''WriteLine(<b>Name</b>);''<br />
* Es ist möglich mehrere Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''WriteLine();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden 2 Variablen miteinander verglichen oder überprüft, ob eine Variable einem Wert entspricht und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 = 42)<br />
{<br />
WriteLine('var1 ist 42');<br />
}<br />
else<br />
{<br />
WriteLine('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 42)</nowiki></pre><br />
Hier wird der Vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgeführt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
WriteLine('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
WriteLine('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
WriteLine('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
WriteLine('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
WriteLine(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
WriteLine('Ich zähle jetzt bis Null');<br />
Do<br />
{<br />
WriteLine(CStr(i));<br />
i = i -1;<br />
}<br />
While (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
WriteLine(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
WriteLine(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>ShipManager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>ShipManager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der ShipManager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
Syntaxe:<br />
ShipManager.TransferiereZuSchiff(''Schiffid'', ''Menge'', EBeamRessource.''Ware'');<br />
Hier musst du nun nurnoch den kursiven Text mit deinen Angaben ersetzten. Hier ein Beispiele:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.TransferiereZuSchiff(2, 20, EBeamRessource.Nahrung);<br />
Natürlich kann man auch eine ganze Flotte beamen lassen, dazu ersetzt du ''ShipManager.BenutzteSchiff(1);'' durch ''ShipManager.BenutzteFlotte(1);'' Dann sieht das Script folgendermasen aus:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.TransferiereZuSchiff(2, 20, EBeamRessource.Nahrung);<br />
<br />
===Fliegen===<br />
Bei der Syntaxe gibt es 2 Möglichkeiten, die eine für Spieler unter Level 8 oder mit [[Feature-Pack]], also mit Autopilot, und die andere für die Leute über Level 8 und ohne Feature-Pack, die Variante ohne Autopilot.<br />
====Fliegen mit dem Autopiloten====<br />
<font color="red">'''''Nur für Spieler mit Feature-Pack oder unter Kolonisationslevel 8 möglich!'''''</font><br />
<br />
Der Befehl:<br />
ShipManager.FliegeZu(''xxx|yyy'');<br />
Auch hier Gilt es wieder das kursive durch die eigenen Angaben zu ersetzten. Wie in folgendem Beispiel:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.FliegeZu('123|465');<br />
oder mit dem Flottenbefehl:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.FliegeZu('123|465');<br />
Mit deisem Befehl fliegt das Schiff zu einer belibigen Position, [[NPC|NPC-Gebiete]] ausgenommen, und umgeht dabei wie der Autopilot Energie-intensive Hindernisse, sowie solche die das Schiff oder die Crew Gefährden.<br />
<br />
====Fliegen ohne Autopilot====<br />
Der Befehl hierzu sieht wie folgt aus:<br />
ShipManager.Fliege(''Strecke'', EShipRichtung.''Richtung'');<br />
Auch hier ersetzt du die kursiven Worte mit deinen Angaben, ein Beispiel folgt:<br />
ShipManager.BenutzteSchiff(1);<br />
ShipManager.Fliege(5, EShipRichtung.Hoch);<br />
ShipManager.Fliege(8, EshipRichtung.Links);<br />
oder wenn es eine ganze Flotte ist:<br />
ShipManager.BenutzteFlotte(1);<br />
ShipManager.Fliege(5, EShipRichtung.Hoch);<br />
ShipManager.Fliege(8, EshipRichtung.Links);<br />
<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
===Alternative zum Schiffsmanager: Schiffsaktion===<br />
<br />
Für Objekte des Typ's CMyFlotte und CMyShip kann über die Eigenschaft Aktion direkt auf die Funktionen des Schiffsmanagers zugegriffen werden.<br />
<br />
<pre><nowiki>VAR Schiff AS CMyShip = new CMyShip( 4711 )<br />
Schiff.Aktion.Abdocken()</nowiki></pre><br />
<br />
<pre><nowiki>VAR Flotte AS CMyFlotte = new CMyFlotte( 4711 )<br />
Flotte.Aktion.Abdocken()</nowiki></pre><br />
<br />
==Enumeration ist Alles==<br />
kommt noch<br />
<br />
==Methoden==<br />
<br />
Öfters wiederkehrende Aufgaben können in Methoden zusammengefasst werden:<br />
<pre><nowiki><br />
Function ShowKoords(x As Integer, y As Integer)<br />
{<br />
WriteLine(CStr(x) + '|' + CStr(y));<br />
}<br />
</nowiki></pre><br />
Die Methode ShowKoords kann dann im Script folgendermaßen aufgerufen werden:<br />
<pre><nowiki><br />
ShowKoords(3, 4);<br />
ShowKoords(ship.MapPosition.X,ship.MapPosition.Y);<br />
</nowiki></pre><br />
Wenn berechnete Werte von der Methode zurückgegeben werden sollen:<br />
<pre><nowiki><br />
Function Distanz(x1 As Integer, y1 As Integer, x2 As Integer, y2 As Integer) As Integer<br />
{<br />
Var distanz As Integer;<br />
<br />
distanz = Math.Abs(x1 - x2) + Math.Abs(y1 - y2);<br />
Return(distanz);<br />
}<br />
<br />
WriteLine(Distanz(1, 1, 5, 5));<br />
</nowiki></pre><br />
Einfache Typen werden immer 'ByVal' übergeben, d.h. die Werte werden als Kopie an die Methode übergeben und die entsprechenden Variablen im Script nicht verändert.<br />
'ByRef' ist zwar in der Scriptengine vorgesehen und kann angegeben werden, ist aber derzeit ohne Funktion.<br />
Objekte werden immer ByRef übergeben.<br />
<br />
==Klassen==<br />
<br />
In Klassen können Daten und Methoden in einem Objekt gekapselt werden:<br />
<br />
<pre><nowiki><br />
Class CKoords<br />
{<br />
Var x As Integer;<br />
Var y As Integer;<br />
<br />
Function New(x As Integer, y As Integer)<br />
{<br />
This.x = x;<br />
This.y = y;<br />
}<br />
<br />
Function ToString() As String<br />
{<br />
Return((CStr(x) + '|' + CStr(y));<br />
}<br />
<br />
Function Distanz(koord As CKoords) As Integer<br />
{<br />
Return Math.Abs(x - koord.x) + Math.Abs(y - koord.y);<br />
}<br />
}<br />
<br />
Var ko1 As New CKoords(3, 5);<br />
Var ko2 As CKoords;<br />
<br />
<br />
ko2 = New CKoords(8, 9);<br />
WriteLine('Distanz von ' + ko1.ToString() + ' nach ' + ko2.ToString() + ': ' + CStr(ko1.Distanz(ko2)));<br />
</nowiki></pre><br />
<br />
Wichtig: Klassen brauchen immer eine Methode New(), sonst kann kein neues Objekt der Klasse generiert werden!<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2, Kapitel 4<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung Kapitel 1<br />
|-<br />
|Fling<br />
|54865<br />
|Kapitel 7, Kapitel 8<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=HauptseiteHauptseite2008-02-01T22:05:33Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
<br />
{| width="100%"<br />
|-<br />
| width="80%" style="vertical-align:top; border-width:0px"|<br />
<div style="margin:0; margin-right:10px;border:2px solid #1A1C5E;"><br />
<br />
<!-- Begrüßung - 1. Abschnitt links Anfang --><br />
<div style="padding:0.3em 1em 0.7em 1em;"><br />
=='''Willkommen im STNE-Wiki'''==<br />
Willkommen in der Enzyklopädie von STNE. Hier findet ihr Hilfe zu allen Themen rund um STNE, könnt euch, eure Völker, Allianzen und Geschichten veröffentlichen. <br />
</div><br />
<!-- Navigationsleiste Themen --><br />
<div style="text-align:center; padding:7px 0px 4px 0px; border:0px solid #1A1C5E; border-width:1px 0px 0px 0px;"><big>'''[http://game.stne.net/ STNE - Das Spiel] · [http://status.delta-times.de STNE-Statusseite] · [http://forum.stne.net/ STNE-Forum] <br> [[STNE-Team-Liste]] · [[News:Hauptseite|Wiki-Zeitung]]'''</big> </div><br />
</div><br />
<!-- Begrüßung - 1. Abschnitt links Ende --><br />
<!-- unsichtbar - 2. Abschnitt links Anfang <br />
<div style="margin:10px 10px 0px 0px; border:2px solid #dfdfdf; padding:0.6em; "><br />
'''Wiki-News'''<br />
textetxt<br />
</div> <br />
</div><br />
unsichtbar - 2. Abschnitt links Ende--><br />
<!-- Wie benutze ich ... - 3. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em; "><br />
<br />
== '''Schnellstart''' ==<br />
* '''[[STNE2|Änderungen in STNE 2]]'''<br />
* [[Inhalt|Inhaltsverzeichnis]]<br />
* [[Index|Von A bis Z]]<br />
* [[Abkürzungsverzeichnis]]<br />
* [[:Kategorie:Allgemeines|thematische Suche]]<br />
* [[Hilfe:Cattree|Themenbaum]]<br />
* [[Spezial:Specialpages|Suchen in speziellen Seiten]]<br />
* [[Spezial:Search|Wiki-Suchfunktion]]<br />
* [http://www.google.de/custom?sa=Google+Search&domains=wiki.stne.net&sitesearch=wiki.stne.net Googlesuche im STNE-Wiki]<br />
<br />
<div align="right"><small>'''mehr über [[Hilfe:Suche|suchen im Wiki]]... ''' </small></div><br />
</div><br />
<!-- Wie benutze ich ... - 3. Abschnitt links Ende --><br />
<!-- Wichtige Links - 4. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Schon gewußt, dass ...'''==<br />
{{HS-Doyouknow}}<br />
</div><br />
<!-- Wichtige Links - 4. Abschnitt links Ende --><br />
<!-- News - 5. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Wiki-News''' ==<br />
{{HS-News}}<br />
</div><br />
<!-- News - 5. Abschnitt links Ende --><br />
<!-- RECHTE SPALTE --><br />
<!-- Logo - 1. Abschnitt rechts Anfang --><br />
| width="48%" style="vertical-align:top; border-width:0px" |<br />
<div style="margin:0; border:2px solid gold padding:0em 1em 1em 1em;"><br />
<center>[[Bild:warp5.jpg]]</center><br />
</div><br />
<!-- Logo - 1. Abschnitt rechts Ende --><br />
<!-- Schnellstart - 2. Abschnitt rechts Anfang --><br />
<div style="margin:0; margin-top:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Hilfe zum STNE-Wiki?''' ==<br />
Hilfe zum STNE-Wiki findet ihr hier:<br />
* [[STNE-Wiki:Hilfe|STNE-Wiki-Hilfe]]<br />
* im [[IRC]] im Channel #wiki<br />
* einen Admin aus dieser [[STNE-Wiki:Administratoren|Liste]] ingame anschreiben<br />
* [http://wiki.stne.net/index.php?title=Hilfe:Fragen_zum_STNE-Wiki&action=edit&section=new ...oder stelle deine Frage hier]<br />
</div><br />
<!-- Schnellstart - 2. Abschnitt rechts Ende --><br />
<!-- Wiki-Mitarbeit - 3. Abschnitt rechts Anfang --><br />
<div style="margin:0; margin-top:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em; margin-top:10px;"><br />
<br />
== '''Wiki-Mitarbeit''' ==<br />
Jeder im Wiki angemeldete Spieler kann am Wiki mit arbeiten. Alles was ihr dazu braucht ist ein wenig Zeit und etwas Wissen, dass ihr mit anderen teilen wollt. Im Moment werden vor allem Helfer zum Thema Kampf (zwischen Schiffen, Schiff - Planet etc.) gesucht. Ebenso warten noch viele Einzelseiten auf einen Inhalt. Ihr findet diese Seiten [[Spezial:Wantedpages|hier]]. Auch viele der bereits vorhandenen Seiten warten auf Ergänzungen oder Korrekturen. Schaut einfach mal rein ...<br />
<br><br />
Hilfreiche Links zum Thema Wiki-Mitarbeit findet ihr hier:<br />
* [[STNE-Wiki:Hilfe|STNE-Wiki-Hilfe]]<br />
* [http://de.wikipedia.org/wiki/Wikipedia:Erste_Schritte erste Schritte im Wiki]<br />
* [http://meta.wikipedia.org/wiki/MediaWiki_i18n Dokumentation zur Anpassung der Benutzeroberfläche]<br />
* [http://de.wikipedia.org/wiki/Wikipedia:Handbuch Benutzerhandbuch]<br><br><br />
Bitte tragt auf jeder Seite ganz oben <nowiki>{{menue}}</nowiki> und ganz unten <nowiki>[[Kategorie:kategoriename]]</nowiki> ein. <br><br />
<div align="right"><small>'''mehr über [[Wiki-Mitarbeit]]'''</small></div><br />
</div><br />
<!-- Wiki-Mitarbeit - 3. Abschnitt rechts Ende --><br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=HauptseiteHauptseite2008-02-01T22:04:59Z<p>Arakis: </p>
<hr />
<div>{{menue}}<br />
__NOTOC__<br />
__NOEDITSECTION__<br />
<br />
{| width="100%"<br />
|-<br />
| width="80%" style="vertical-align:top; border-width:0px"|<br />
<div style="margin:0; margin-right:10px;border:2px solid #1A1C5E;"><br />
<br />
<!-- Begrüßung - 1. Abschnitt links Anfang --><br />
<div style="padding:0.3em 1em 0.7em 1em;"><br />
=='''Willkommen im STNE-Wiki'''==<br />
Willkommen in der Enzyklopädie von STNE. Hier findet ihr Hilfe zu allen Themen rund um STNE, könnt euch, eure Völker, Allianzen und Geschichten veröffentlichen. <br />
</div><br />
<!-- Navigationsleiste Themen --><br />
<div style="text-align:center; padding:7px 0px 4px 0px; border:0px solid #1A1C5E; border-width:1px 0px 0px 0px;"><big>'''[http://game.stne.net/ STNE - Das Spiel] · [http://status.delta-times.de STNE-Statusseite] · [http://forum.stne.net/ STNE-Forum] <br> [[STNE-Team-Liste]] · [[News:Hauptseite|Wiki-Zeitung]]'''</big> </div><br />
</div><br />
<!-- Begrüßung - 1. Abschnitt links Ende --><br />
<!-- unsichtbar - 2. Abschnitt links Anfang <br />
<div style="margin:10px 10px 0px 0px; border:2px solid #dfdfdf; padding:0.6em; "><br />
'''Wiki-News'''<br />
textetxt<br />
</div> <br />
</div><br />
unsichtbar - 2. Abschnitt links Ende--><br />
<!-- Wie benutze ich ... - 3. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em; "><br />
<br />
== '''Schnellstart''' ==<br />
* [[STNE2|Änderungen in STNE 2]]<br />
* [[Inhalt|Inhaltsverzeichnis]]<br />
* [[Index|Von A bis Z]]<br />
* [[Abkürzungsverzeichnis]]<br />
* [[:Kategorie:Allgemeines|thematische Suche]]<br />
* [[Hilfe:Cattree|Themenbaum]]<br />
* [[Spezial:Specialpages|Suchen in speziellen Seiten]]<br />
* [[Spezial:Search|Wiki-Suchfunktion]]<br />
* [http://www.google.de/custom?sa=Google+Search&domains=wiki.stne.net&sitesearch=wiki.stne.net Googlesuche im STNE-Wiki]<br />
<br />
<div align="right"><small>'''mehr über [[Hilfe:Suche|suchen im Wiki]]... ''' </small></div><br />
</div><br />
<!-- Wie benutze ich ... - 3. Abschnitt links Ende --><br />
<!-- Wichtige Links - 4. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Schon gewußt, dass ...'''==<br />
{{HS-Doyouknow}}<br />
</div><br />
<!-- Wichtige Links - 4. Abschnitt links Ende --><br />
<!-- News - 5. Abschnitt links Anfang --><br />
<div style="margin:0; margin-top:10px; margin-right:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Wiki-News''' ==<br />
{{HS-News}}<br />
</div><br />
<!-- News - 5. Abschnitt links Ende --><br />
<!-- RECHTE SPALTE --><br />
<!-- Logo - 1. Abschnitt rechts Anfang --><br />
| width="48%" style="vertical-align:top; border-width:0px" |<br />
<div style="margin:0; border:2px solid gold padding:0em 1em 1em 1em;"><br />
<center>[[Bild:warp5.jpg]]</center><br />
</div><br />
<!-- Logo - 1. Abschnitt rechts Ende --><br />
<!-- Schnellstart - 2. Abschnitt rechts Anfang --><br />
<div style="margin:0; margin-top:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em;"><br />
<br />
== '''Hilfe zum STNE-Wiki?''' ==<br />
Hilfe zum STNE-Wiki findet ihr hier:<br />
* [[STNE-Wiki:Hilfe|STNE-Wiki-Hilfe]]<br />
* im [[IRC]] im Channel #wiki<br />
* einen Admin aus dieser [[STNE-Wiki:Administratoren|Liste]] ingame anschreiben<br />
* [http://wiki.stne.net/index.php?title=Hilfe:Fragen_zum_STNE-Wiki&action=edit&section=new ...oder stelle deine Frage hier]<br />
</div><br />
<!-- Schnellstart - 2. Abschnitt rechts Ende --><br />
<!-- Wiki-Mitarbeit - 3. Abschnitt rechts Anfang --><br />
<div style="margin:0; margin-top:10px; border:2px solid #1A1C5E; padding:0em 1em 1em 1em; margin-top:10px;"><br />
<br />
== '''Wiki-Mitarbeit''' ==<br />
Jeder im Wiki angemeldete Spieler kann am Wiki mit arbeiten. Alles was ihr dazu braucht ist ein wenig Zeit und etwas Wissen, dass ihr mit anderen teilen wollt. Im Moment werden vor allem Helfer zum Thema Kampf (zwischen Schiffen, Schiff - Planet etc.) gesucht. Ebenso warten noch viele Einzelseiten auf einen Inhalt. Ihr findet diese Seiten [[Spezial:Wantedpages|hier]]. Auch viele der bereits vorhandenen Seiten warten auf Ergänzungen oder Korrekturen. Schaut einfach mal rein ...<br />
<br><br />
Hilfreiche Links zum Thema Wiki-Mitarbeit findet ihr hier:<br />
* [[STNE-Wiki:Hilfe|STNE-Wiki-Hilfe]]<br />
* [http://de.wikipedia.org/wiki/Wikipedia:Erste_Schritte erste Schritte im Wiki]<br />
* [http://meta.wikipedia.org/wiki/MediaWiki_i18n Dokumentation zur Anpassung der Benutzeroberfläche]<br />
* [http://de.wikipedia.org/wiki/Wikipedia:Handbuch Benutzerhandbuch]<br><br><br />
Bitte tragt auf jeder Seite ganz oben <nowiki>{{menue}}</nowiki> und ganz unten <nowiki>[[Kategorie:kategoriename]]</nowiki> ein. <br><br />
<div align="right"><small>'''mehr über [[Wiki-Mitarbeit]]'''</small></div><br />
</div><br />
<!-- Wiki-Mitarbeit - 3. Abschnitt rechts Ende --><br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=STNE2STNE22008-02-01T22:03:53Z<p>Arakis: </p>
<hr />
<div>blubb</div>Arakishttps://wiki.stne.net/index.php?title=ItemsItems2007-12-02T22:39:29Z<p>Arakis: </p>
<hr />
<div>Items sind grundsätzlich ersteinmal beliebige "Gegenstände", welche ähnlich wie Waren behandelt werden und auf Schiffen und Kolonien gebeamt werden können. Items können Eigenschaften von Schiffen und Gebäuden manipulieren oder haben spezielle Einwegfunktionen, z.b. einmalig die Schilde voll aufladen. Items können auch einfach nur keine RPG-Gegenstände sein, welche keine Funktion haben.<br />
<br />
Es wird zwischen folgenden Items unterschieden:<br />
- Items für Schiffe<br />
- Schiffsmodule, welche Schiffsfähigkeiten manipulieren<br />
- Items, welche einmalig Schiffswerte ändern<br />
- Items für Gebäude<br />
- Custom-RGP-Items, welche durch Siedler erstellt werden können.<br />
<br />
Zur Zeit gibt es nur Schiffsmodule.<br />
<br />
Je nach Schiffsmodul lassen sich diese Installieren und oder manuell aktivieren/deaktivieren. Bestimmte Module zeigen ihre Wirkung erst nach Installation, andere lassen sich auch ohne Installation aktivieren. Es gibt auch Module, welche sich nicht mehr deaktivieren lassen, nach dem sie installiert wurden.<br />
<br />
Installierte Module lassen sich nicht mehr entfernen und können auch nicht mehr gebeamt werden. Das Modul wird erst bei Zerstörung des Schiffes wieder freigegeben. Dabei werden jedoch die Werte des Moduls herabgesetzt, weil es in seiner Qualität sinkt.<br />
<br />
Zur Zeit gibt es ca. 30 verschiedene Schiffsmodule.<br />
<br />
== Schiffsmodule ==<br />
<br />
'''EPS-Akkumulator''': +40 EPS | -10 Lager<br />
<br />
'''Supraleitender Bussardkollektor''': +1 Bussard Effizienz | -20% Gondeln<br />
<br />
'''Warpgondel''': +50 Gondeln | -20% EPS<br />
<br />
'''Kleines Torpedolager''': +10 Torpedos lagern<br />
<br />
'''Diborit-Emitter-Kristall''': +1 Phaser Stärke<br />
<br />
'''Solarkollektoren''': +Solarkollektoren | -10% Hülle<br />
<br />
'''Replikator''': +Replikator</div>Arakishttps://wiki.stne.net/index.php?title=ItemsItems2007-12-01T14:41:44Z<p>Arakis: </p>
<hr />
<div>Items sind grundsätzlich ersteinmal beliebige "Gegenstände", welche ähnlich wie Waren behandelt werden und auf Schiffen und Kolonien gebeamt werden können. Items können Eigenschaften von Schiffen und Gebäuden manipulieren oder haben spezielle Einwegfunktionen, z.b. einmalig die Schilde voll aufladen. Items können auch einfach nur keine RPG-Gegenstände sein, welche keine Funktion haben.<br />
<br />
Es wird zwischen folgenden Items unterschieden:<br />
- Items für Schiffe<br />
- Schiffsmodule, welche Schiffsfähigkeiten manipulieren<br />
- Items, welche einmalig Schiffswerte ändern<br />
- Items für Gebäude<br />
- Custom-RGP-Items, welche durch Siedler erstellt werden können.<br />
<br />
Zur Zeit gibt es nur Schiffsmodule.<br />
<br />
Je nach Schiffsmodul lassen sich diese Installieren und oder manuell aktivieren/deaktivieren. Bestimmte Module zeigen ihre Wirkung erst nach Installation, andere lassen sich auch ohne Installation aktivieren. Es gibt auch Module, welche sich nicht mehr deaktivieren lassen, nach dem sie installiert wurden.<br />
<br />
Installierte Module lassen sich nicht mehr entfernen und können auch nicht mehr gebeamt werden. Das Modul wird erst bei Zerstörung des Schiffes wieder freigegeben. Dabei werden jedoch die Werte des Moduls herabgesetzt, weil es in seiner Qualität sinkt.<br />
<br />
Zur Zeit gibt es ca. 30 verschiedene Schiffsmodule.</div>Arakishttps://wiki.stne.net/index.php?title=ItemsItems2007-12-01T13:10:29Z<p>Arakis: </p>
<hr />
<div>Items sind grundsätzlich ersteinmal beliebige "Gegenstände", welche ähnlich wie Waren behandelt werden und auf Schiffen und Kolonien gebeamt werden können. Items können Eigenschaften von Schiffen und Gebäuden manipulieren oder haben spezielle Einwegfunktionen, z.b. einmalig die Schilde voll aufladen. Items können auch einfach nur keine RPG-Gegenstände sein, welche keine Funktion haben.<br />
<br />
Es wird zwischen folgenden Items unterschieden:<br />
+ Items für Schiffe<br />
++ Schiffsmodule, welche Schiffsfähigkeiten manipulieren<br />
++ Items, welche einmalig Schiffswerte ändern<br />
+ Items für Gebäude<br />
+ Custom-RGP-Items, welche durch Siedler erstellt werden können.<br />
<br />
Zur Zeit gibt es nur Schiffsmodule.<br />
<br />
Je nach Schiffsmodul lassen sich diese Installieren und oder manuell aktivieren/deaktivieren. Bestimmte Module zeigen ihre Wirkung erst nach Installation, andere lassen sich auch ohne Installation aktivieren. Es gibt auch Module, welche sich nicht mehr deaktivieren lassen, nach dem sie installiert wurden.<br />
<br />
Installierte Module lassen sich nicht mehr entfernen und können auch nicht mehr gebeamt werden. Das Modul wird erst bei Zerstörung des Schiffes wieder freigegeben. Dabei werden jedoch die Werte des Moduls herabgesetzt, weil es in seiner Qualität sinkt.<br />
<br />
Zur Zeit gibt es ca. 30 verschiedene Schiffsmodule.</div>Arakishttps://wiki.stne.net/index.php?title=ItemsItems2007-12-01T13:10:07Z<p>Arakis: </p>
<hr />
<div>Items sind grundsätzlich ersteinmal beliebige "Gegenstände", welche ähnlich wie Waren behandelt werden und auf Schiffen und Kolonien gebeamt werden können. Items können Eigenschaften von Schiffen und Gebäuden manipulieren oder haben spezielle Einwegfunktionen, z.b. einmalig die Schilde voll aufladen. Items können auch einfach nur keine RPG-Gegenstände sein, welche keine Funktion haben.<br />
<br />
Es wird zwischen folgenden Items unterschieden:<br />
+ Items für Schiffe<br />
++ Schiffsmodule, welche Schiffsfähigkeiten manipulieren<br />
++ Items, welche einmalig Schiffswerte ändern<br />
+ Items für Gebäude<br />
+ Custom-RGP-Items, welche durch Siedler erstellt werden können.<br />
<br />
Zur Zeit gibt es nur Schiffsmodule.<br />
<br />
Je nach Schiffsmodul lassen sich diese Installieren und oder manuell aktivieren/deaktivieren. Bestimmte Module zeigen ihre Wirkung erst nach Installation, andere lassen sich auch ohne Installation aktivieren. Es gibt auch Module, welche sich nicht mehr deaktivieren lassen, nach dem sie installiert wurden.<br />
<br />
Installierte Module lassen sich nicht mehr entfernen und können auch nicht mehr gebeamt werden. Das Modul wird erst bei Zerstörung des Schiffes wieder freigegeben. Dabei werden jedoch die Werte des Moduls herabgesetzt, weil es in seiner Qualität sinkt.</div>Arakishttps://wiki.stne.net/index.php?title=ItemsItems2007-12-01T13:09:52Z<p>Arakis: </p>
<hr />
<div>Items sind grundsätzlich ersteinmal beliebige "Gegenstände", welche ähnlich wie Waren behandelt werden und auf Schiffen und Kolonien gebeamt werden können. Items können Eigenschaften von Schiffen und Gebäuden manipulieren oder haben spezielle Einwegfunktionen, z.b. einmalig die Schilde voll aufladen. Items können auch einfach nur keine RPG-Gegenstände sein, welche keine Funktion haben.<br />
<br />
Es wird zwischen folgenden Items unterschieden:<br />
+ Items für Schiffe<br />
++ Schiffsmodule, welche Schiffsfähigkeiten manipulieren<br />
++ Items, welche einmalig Schiffswerte ändern<br />
+ Items für Gebäude<br />
+ Custom-RGP-Items, welche durch Siedler erstellt werden können.<br />
<br />
Zur Zeit gibt es nur Schiffsmodule.<br />
<br />
Je nach Schiffsmodul lassen sich dieser Installieren und oder manuell aktivieren/deaktivieren. Bestimmte Module zeigen ihre Wirkung erst nach Installation, andere lassen sich auch ohne Installation aktivieren. Es gibt auch Module, welche sich nicht mehr deaktivieren lassen, nach dem sie installiert wurden.<br />
<br />
Installierte Module lassen sich nicht mehr entfernen und können auch nicht mehr gebeamt werden. Das Modul wird erst bei Zerstörung des Schiffes wieder freigegeben. Dabei werden jedoch die Werte des Moduls herabgesetzt, weil es in seiner Qualität sinkt.</div>Arakishttps://wiki.stne.net/index.php?title=ItemsItems2007-12-01T13:07:07Z<p>Arakis: </p>
<hr />
<div>Items sind grundsätzlich ersteinmal beliebige "Gegenstände", welche ähnlich wie Waren behandelt werden und auf Schiffen und Kolonien gebeamt werden können. Items können Eigenschaften von Schiffen und Gebäuden manipulieren oder haben spezielle Einwegfunktionen, z.b. einmalig die Schilde voll aufladen. Items können auch einfach nur keine RPG-Gegenstände sein, welche keine Funktion haben.<br />
<br />
Es wird zwischen folgenden Items unterschieden:<br />
+ Items für Schiffe<br />
++ Schiffsmodule, welche Schiffsfähigkeiten manipulieren<br />
++ Items, welche einmalig Schiffswerte ändern<br />
+ Items für Gebäude<br />
+ Custom-RGP-Items, welche durch Siedler erstellt werden können.<br />
<br />
Zur Zeit gibt es nur Schiffsmodule.</div>Arakishttps://wiki.stne.net/index.php?title=Scripting_Diskussion:KolonieEnergie_optimierenScripting Diskussion:KolonieEnergie optimieren2007-05-02T20:45:25Z<p>Arakis: /* Optimierung */</p>
<hr />
<div>== Optimierung ==<br />
<br />
Du brauchst keine Enumerator, du kannst direkt FOR (haus IN colo.Gebäude){} schreiben. Desweiteren ist es besser statt haus.TypName='Solarsatelit' lieber haus.Typ = EGebäudeTyp.Solarsatelit zu schreiben. Und anstatt die Position zusammenzubauen kannst du besser haus.Feld.Position.ToString() schreiben.<br />
[[Spieler:Arakis|Arakis]] 22:43, 2. Mai 2007 (W. Europe Daylight Time)</div>Arakishttps://wiki.stne.net/index.php?title=Scripting_Diskussion:KolonieEnergie_optimierenScripting Diskussion:KolonieEnergie optimieren2007-05-02T20:43:56Z<p>Arakis: Optimierung</p>
<hr />
<div>== Optimierung ==<br />
<br />
Du brauchst keine Enumerator, du kannst direkt FOR (haus IN colo.Gebäude){} schreiben. Desweiteren ist es besser statt haus.TypName='Solarsatelit' lieber haus.Typ = EGebäudeTyp.Solarsatelit zu schreiben.<br />
[[Spieler:Arakis|Arakis]] 22:43, 2. Mai 2007 (W. Europe Daylight Time)</div>Arakishttps://wiki.stne.net/index.php?title=Scripting_Diskussion:FlottenScripting Diskussion:Flotten2006-07-29T09:52:33Z<p>Arakis: </p>
<hr />
<div>Ich möchte wetten dass du den Soruce nicht einmal selber getestet hast, es gibt schwere Syntaxfehler im Code.<br />
[[Spieler:Arakis|Arakis]] 11:52, 29. Jul 2006 (W. Europe Daylight Time)</div>Arakishttps://wiki.stne.net/index.php?title=Vorlage:AktuellenScript-ArtikelVorlage:AktuellenScript-Artikel2006-06-23T12:55:30Z<p>Arakis: </p>
<hr />
<div>* [[Scripting:Anfängerkurs|Anfängerkurs]] - Einführung in die Script-Engine<br />
* [[Scripting:Flotten_benennen|Flotten Benennen]] - Script zum Benennen von größeren Flotten<br />
* [[Scripting:Deutsammeln%28flotte%29|Deutsammeln(flotte)]] - Script zum [[Deuterium]]-Sammeln mit einer Flotte<br />
* [[Scripting:BinarySearch|BinarySearch]] - durchsucht sortierte Arrays nach einer Zahl<br />
* [[Scripting:BubbleSort|BubbleSort]] - sortiert Zahlen-Arrays<br />
* [[Scripting:FAQ|FAQ]] - beantwortet Fragen rund ums Scripten in STNE<br />
* [[Scripting:Syntax|Syntax]] - kurze Syntax-Beschreibung<br />
* [[Scripting:TestSkript0.11|TestSkript0.11]] - demonstriert die wesentlichen Funktionen</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2006-06-23T12:38:26Z<p>Arakis: /* Variablen setzen */</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>writeline('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>writeline('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von verschiedenen Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - <br />
* Integer -<br />
* Boolean -<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''var'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. optional danach kann ein as stehen (as, engl., als) dieses gibt an was für einen Inhalt die Variable hat, zb. str für string also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>var i1 as string</pre><br />
Um einer Variable einen Inhalt zuzuordnen setzt man die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt in unserem nächsten Beispiel ein String.<br />
<pre>var test as string<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>var test as string = 'Hallo!'</pre><br />
Auch hier sehen wir wieder die einfachen Anführungszeichen als Kennzeichen für einen String. Wir können Variablen aber auch andere Werte wie Integer oder Bolean zuweisen. Dazu einfach str durch den jewaligen Typ ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hirzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>var test as string = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
var test as string = 'Hallo!'<br />
writeline( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeiche eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur das sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
var test as string = 'Hallo!'<br />
writeline(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet Integer intern anders als String. String kann er ausgeben Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
writeline(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
*<br />
*<br />
*<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden einfach 2 Variablen miteinander verglichen und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (varl1 = 42)<br />
{<br />
writeline('var1 ist 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 1)</nowiki></pre><br />
Hier wird der vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgehührt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
writeline('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
writeline('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
writeline('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
writeline(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
writeline('Ich zähle jetzt bis Null');<br />
{<br />
writeline(CStr(i));<br />
i = i -1;<br />
}<br />
Do (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>Shipmanager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>Shipmanager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der Shipmanager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
kommt noch<br />
===Fliege===<br />
kommt noch<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2006-06-23T12:37:45Z<p>Arakis: Es gibt keinen Datentypen "str"</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>writeline('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>writeline('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von verschiedenen Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - <br />
* Integer -<br />
* Boolean -<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''var'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. optional danach kann ein as stehen (as, engl., als) dieses gibt an was für einen Inhalt die Variable hat, zb. str für string also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>var i1 as str</pre><br />
Um einer Variable einen Inhalt zuzuordnen setzt man die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt in unserem nächsten Beispiel ein String.<br />
<pre>var test as string<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>var test as string = 'Hallo!'</pre><br />
Auch hier sehen wir wieder die einfachen Anführungszeichen als Kennzeichen für einen String. Wir können Variablen aber auch andere Werte wie Integer oder Bolean zuweisen. Dazu einfach str durch den jewaligen Typ ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hirzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>var test as string = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
var test as string = 'Hallo!'<br />
writeline( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeiche eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur das sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
var test as string = 'Hallo!'<br />
writeline(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet Integer intern anders als String. String kann er ausgeben Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
writeline(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
*<br />
*<br />
*<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden einfach 2 Variablen miteinander verglichen und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (varl1 = 42)<br />
{<br />
writeline('var1 ist 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 1)</nowiki></pre><br />
Hier wird der vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgehührt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
writeline('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
writeline('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
writeline('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
writeline(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
writeline('Ich zähle jetzt bis Null');<br />
{<br />
writeline(CStr(i));<br />
i = i -1;<br />
}<br />
Do (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>Shipmanager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>Shipmanager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der Shipmanager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
kommt noch<br />
===Fliege===<br />
kommt noch<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2006-06-23T12:36:46Z<p>Arakis: /* Variablen setzen */</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>writeline('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>writeline('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von verschiedenen Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - <br />
* Integer -<br />
* Boolean -<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''var'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. optional danach kann ein as stehen (as, engl., als) dieses gibt an was für einen Inhalt die Variable hat, zb. str für string also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>var i1 as str</pre><br />
Um einer Variable einen Inhalt zuzuordnen setzt man die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt in unserem nächsten Beispiel ein String.<br />
<pre>var test as string<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>var test as str = 'Hallo!'</pre><br />
Auch hier sehen wir wieder die einfachen Anführungszeichen als Kennzeichen für einen String. Wir können Variablen aber auch andere Werte wie Integer oder Bolean zuweisen. Dazu einfach str durch den jewaligen Typ ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hirzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>var test as str = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
var test as str = 'Hallo!'<br />
writeline( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeiche eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur das sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
var test as str = 'Hallo!'<br />
writeline(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet Integer intern anders als String. String kann er ausgeben Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
writeline(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
*<br />
*<br />
*<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden einfach 2 Variablen miteinander verglichen und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (varl1 = 42)<br />
{<br />
writeline('var1 ist 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 1)</nowiki></pre><br />
Hier wird der vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgehührt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
writeline('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
writeline('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
writeline('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
writeline(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
writeline('Ich zähle jetzt bis Null');<br />
{<br />
writeline(CStr(i));<br />
i = i -1;<br />
}<br />
Do (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>Shipmanager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>Shipmanager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der Shipmanager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
kommt noch<br />
===Fliege===<br />
kommt noch<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Anf%C3%A4ngerkursScripting:Anfängerkurs2006-06-23T12:35:48Z<p>Arakis: /* Variablen setzen */</p>
<hr />
<div>{{Scriptingmenue}}<br />
'''Hier wird in nächster Zeit ein Anfängerkurs für die STNE-Scriptengine entstehen. Wer mithelfen will oder bereits jetzt fragen hat kann sich vertrauensvoll an uns wenden, einfach im irc den channel #scripting joinen!'''<br />
<br />
__TOC__<br />
==Vorwort==<br />
Dieser Kurs richtet sich vor allem an diejenigen, die zuvor noch nie mit Programmierung zu tun hatten und trotzdem gerne Scripts für STNE schreiben würden. Die sollen hier auf möglichst einfache Weise einen Einstieg finden. <br />
Aber bitte erwartet keine Wunder, niemand der keine Ahnung vom Programieren hat, kann dies über Nacht lernen. Daher ist insbesondere eine Sache von enormer Wichtigkeit: Geduld – denn nur wer mit Geduld die Sachen angeht wird letzten Endes mit einem funktionieren Script belohnt. Wer die schnellen Erfolge sucht, der sollte es gleich lassen.<br />
Wir wünschen allen viel Spaß und gutes Gelingen.<br />
==Kapitel 1 - Strings==<br />
===String? - Kann man das essen?===<br />
'''Nein''', ein String (englisch) oder eine Zeichenkette, ist eine Folge von Zeichen (z.B. Buchstaben, Ziffern, Sonderzeichen, und Steuerzeichen) aus einem definierten Zeichensatz.<br />
<br />
Nun wissen wir also, was dieser ominöse String überhaupt ist. Wenden wir uns nun zur Ausgabe von Strings!<br />
<br />
=== Ausgabe von Strings ===<br />
In diesem Kapitel werden wir uns der einfachen Ausgabe von Strings zuwenden. Um einen String auszugeben, müssen wir uns natürlich erst einmal überlegen was wir überhaupt ausgeben wollen. Nehmen wir als Beispiel einfach ''"Hallo!"''. Als Nächstes müssen wir wissen wie wir der Engine sagen, dass sie etwas ausgeben soll! Dies geschieht mit dem Befehl ''writeline();''.<br />
<br />
Hier ein kleines Beispiel:<br />
<pre>writeline('Hallo!');</pre><br />
<br />
In den Klammern steht immer der String, der ausgegeben werden soll. Die einfachen Anführungszeichen sagen dem Befehl, dass das Nachfolgende ein String und keine Variable ist (Was eine Variable ist erfahren wir im nächsten Kapitel). Das Semikolon signalisiert der Engine, dass der Befehl hier endet, dies wird nicht bei jedem Befehl benötigt.<br />
<br />
Wenn man sich mehrere Strings nach einander ausgeben möchte, ist es natürlich unsinnig, für jedes Wort einen neuen ''writeline();'' Befehl auszuführen. Also kann man Strings an einander reihen. Hierzu setzt man einfach ein ''&''-Zeichen zwischen die Strings. Natürlich kann man auch die jeweiligen Strings einfach, wie wir noch später lernen durch Variablen ersetzen.<br />
<pre>writeline('Hallo!' & ' Wie geht es?');</pre><br />
Wichtig hierbei ist, dass das ''&''-Zeichen kein Leerzeichen einfügt. Dies muss manuell innerhalb des Strings passieren.<br />
<br />
===Zusammenfassung: Strings===<br />
<br />
* Ein String ist eine Folge von verschiedenen Zeichen.<br />
* Zum Ausgeben von Strings wird ''writeline();'' verwendet.<br />
* Es ist möglich mehrere Strings bzw. Variablen mit Hilfe des ''&''-Zeichens innerhalb des Befehls ''writeline();'' regelrecht anzuhängen.<br />
<br />
==Kapitel 2 - Variablen==<br />
===Variablen? - Schon wieder was zum futtern?===<br />
'''Nein''', lediglich ein weiterer Fachbegriff der Programmierer. Variablen sind eine Art von Platzhalter, in denen man Informationen, wie zum Beispiel Strings, für eine spätere Verwendung abspeichern kann. Natürlich gibt es für verschiedene Informationen ganz spezielle und verschiedene Variablentypen, die man auch [[Scripting:Datentypen|Datentypen]] nennt.<br />
<br />
Die wichtigsten [[Scripting:Datentypen|Datentypen]] sind:<br />
* String - <br />
* Integer -<br />
* Boolean -<br />
<br />
===Variablen setzen===<br />
Da das Arbeiten mit statischen Daten auf Dauer, vor allem bei längeren Scripten, ziemlich zeitaufwendig und unflexibel ist, verwendet man Variablen. Diese speichern Daten, geben sie auf Wunsch aus und lassen sich auch belibig oft verändern.<br />
<br />
Um eine Variable zu erschaffen verwendet man den Befehl ''var''. <br />
<br />
<br />
<br />
Nach ''var'' kommt dann der Variablen Name, dieser darf Zahlen und Buchstaben enthalten. Zahlen allerdings nur mit einer Ausnahme, sie dürfen nicht an erster Stelle stehen. optional danach kann ein as stehen (as, engl., als) dieses gibt an was für einen Inhalt die Variable hat, zb. str für string also eine Zeichenkette. Hier ein Beispiel:<br />
<pre>var i1 as str</pre><br />
Um einer Variable einen Inhalt zuzuordnen setzt man die Variable vor ein Gleichheitszeichen, dahinter kommt dann der Inhalt in unserem nächsten Beispiel ein String.<br />
<pre>var test as str<br />
test = 'Hallo!'</pre><br />
man kann das ganze auch in eine Zeile packen, das sieht dann wie folgt aus:<br />
<pre>var test as str = 'Hallo!'</pre><br />
Auch hier sehen wir wieder die einfachen Anführungszeichen als Kennzeichen für einen String. Wir können Variablen aber auch andere Werte wie Integer oder Bolean zuweisen. Dazu einfach str durch den jewaligen Typ ersetzten.(Liste der Typen: [[Scripting:Typen|klick mich]])<br />
<br />
Auch kann man die Variable "leeren" hirzu gibt man ihr einfach nichts mit, hier auch dazu ein Beispiel:<br />
<pre>var test as str = 'Hallo!'<br />
test = ''</pre><br />
<br />
===Anwendungsbeispiele mit Variablen===<br />
var test as str = 'Hallo!'<br />
writeline( test & ' Wie gehts?');<br />
Auch hier ist weider zu beachten das kein Leerzeiche eingefügt wird! Die Variable kann an jeder Stelle innerhalb der Klammern stehen, zu beachten ist nur das sie nicht innerhalb von Anführungszeichen steht sonst wird die Variable als String gewertet.<br />
var test as str = 'Hallo!'<br />
writeline(test);<br />
Hier wird nun zum Beispiel nur eine Variable ausgegeben.<br />
<br />
===Umwandlung von Variablen in andere Datentypen===<br />
Wollen wir eine Integer-Variable ausgeben, so bekommen wir ein Problem. Der Computer verarbeitet Integer intern anders als String. String kann er ausgeben Integer nicht. Daher müssen alle Integervariablen (wie allen anderen auch) in Stringvariablen umgewandelt werden, bevor man diese ausgeben kann.<br />
Die geschieht über den Befehl <br />
<pre><nowiki>CStr();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR zahl AS Integer;<br />
zahl = 5;<br />
writeline(CStr(Zahl));<br />
</nowiki></pre><br />
<br />
Umgekehrt müssen Stringvariablen in Integer umgewandelt werden, wenn mit diesen zum Beispiel gerechnet werden soll.<br />
Dies geschießt über:<br />
<pre><nowiki>CInt();</nowiki></pre><br />
Beispiel:<br />
<pre><nowiki><br />
VAR einstring AS String;<br />
VAR einezahl AS Integer;<br />
einstring = '42';<br />
einezahl = CInt(einstring);<br />
</nowiki></pre><br />
<br />
===Regeln bei der Bennenung von Variablen===<br />
<br />
*<br />
*<br />
*<br />
*<br />
<br />
===Zusammenfassung: Variablen===<br />
<br />
==Kapitel 3 - Kontrollstrukturen==<br />
Da wir uns in Kapitel 2 mit Variablen beschäftigt haben, können wir uns nun dem eigentlichen Aufwand beim Programmieren zuwenden: den Kontrollstrukturen. Diese Wort klingt ersteinmal sehr hochtrabend, an und für sich ist es jedoch sehr einfach.<br />
<br />
===If - then - Else===<br />
Es werden einfach 2 Variablen miteinander verglichen und dann wird darauf reagiert.<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (varl1 = 42)<br />
{<br />
writeline('var1 ist 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist nicht 42');<br />
}<br />
</nowiki></pre><br />
Dies ist ersteinmal sehr einfach und wirkt auf den ersten Blick sinnlos, was es auch ist. Aber es zeigt auf einfache Art, wie man 2 Werte miteinander vergleicht, dies kann man zum Beispiel dafür nutzen, um zu prüfen wieviel Lageraum ein Schiff noch hat. Dazu aber irgendwann später mehr.<br />
Bleiben wir bei dem Code und schauen ihn uns einmal genauer an:<br />
In der ersten Zeile wird die Variable '''var1''' definiert, dies sollte aus Kapitel 2 bekannt sein.<br />
<pre><nowiki>If (var1 = 1)</nowiki></pre><br />
Hier wird der vergleich durgeführt, in diesem Fall wir geschaut ob der Wert von Zahl1 42 ist. <br />
Man könnte an dieser Stelle genausogut prüfen ob der Wert größer oder kleiner ist, als ein anderer.<br />
Hierfür nutzt man dann nicht "=" sondern "<",">","<=",">="<br />
Innerhalb der { } folgt dann der Code, welcher ausgehührt werden soll, wenn die Bedigung stimmt, also in diesem Fall, wenn '''var1 ''' gleich 42 ist. <br />
<br />
Das folgende ''Else'' mit den Klammern gibt, welche Aktionen ausgeführt werden sollen, wenn die Bedingung nicht stimmt.<br />
<br />
Zu guter letzt gibt es noch ''Elseif'' dies ist dafür gedacht wenn man mehr als eine Alternative hat.<br />
Beispiel<br />
<pre><nowiki><br />
VAR var1 AS Integer = 42;<br />
if (var1 < 42)<br />
{<br />
writeline('var1 ist kleiner als 42');<br />
}<br />
elseif (var1 > 42)<br />
{<br />
writeline('var1 ist größer als 42');<br />
}<br />
else<br />
{<br />
writeline('var1 ist weder größer noch kleiner als 42');<br />
}<br />
</nowiki></pre><br />
Dies ist nicht auf ein ''elseif'' beschränkt, es können beliebig viele sein.<br />
<br />
===Schleifen===<br />
Die soeben kennen gelernten Strukturen helfen uns Fallunterscheidungen zu machen. Aber was machen wir wenn wir eine ganze Liste (zum Beispiel Schiffe) haben und die abarbeiten wollen? Dafür gibt es ''Schleifen'', hier unterscheid man in drei Arten: Kopf-, Fuss- und Zählergesteuert.<br />
====while====<br />
While Schleifen sind Kopfgesteuert, dass heißt, solange die Bedingung zutrifft, wird der Inhalt der Schleife ausgeführt.<br />
Es gelten die selben Operatoren wie bei Abfragen mit if: =,<,>,>=,<=,<><br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 0;<br />
writeline('Ich zähle jetzt bis Zehn');<br />
while ( i <= 10)<br />
{<br />
writeline(CStr(i));<br />
i = i + 1;<br />
}<br />
</nowiki></pre><br />
Solange '''i''' kleiner oder gleich 10 ist, wird '''i''' ausgegeben und dann einen hochgezählt. <br />
Bei Whileschleifen ist zu beachten, dass wenn die Bedingung zu Anfang bereits '''nicht''' erfüllt ist, dass sie dann nicht durchläuft. Soll sie mindestens einmal durchlaufen muss man Fussgesteuerte Schleifen wählen.<br />
====Do====<br />
Do-Schleifen sind Fussgesteuert. Sie funktionieren wie While-Schleifen nur das sie mindestens einmal durchlaufen.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
i = 10;<br />
writeline('Ich zähle jetzt bis Null');<br />
{<br />
writeline(CStr(i));<br />
i = i -1;<br />
}<br />
Do (i >= 0);<br />
</nowiki></pre><br />
Gebe '''i''' solange aus und zähle einen runter, solange '''i''' größer gleich null ist.<br />
Aus der Beschreibung wird deutlich wo der unterschied zwischen While- und Do-Schleifen liegt.<br />
<br />
In beiden Schleifen wird deutlich das ich jedes mal die Variable '''i''' runter bzw. hochzählen muss, um dies zu umgehen gibt es die möglichkeit Zählergesteuerte Schleifen zu verwenden.<br />
====For====<br />
For-Schleifen sind genau dies. <br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
auf diese Weise kann man sich ein wenig Arbeit abnehmen, da die Schleife einem das Zählen abnimmt. So kann man auch Endlosschleifen vermeiden, die auftreten wenn man vergisst, die Schleifenvariable (in diesen Fällen immer '''i''') runter- bzw. hochzuzählen.<br />
<br />
For-Schleifen bieten noch eine weitere Möglichkeit: Es kann angegeben werden in welchen Schritten die Schleife zählt.<br />
<pre><nowiki><br />
VAR i AS Integer;<br />
For ( i = 0 To 100 Step 10)<br />
{<br />
writeline(CStr(i));<br />
}</nowiki></pre><br />
Der Code ist der bis auf das ''Step'' identisch. Die Zahl die hinter Step steht kann sowohl positiv als auch negativ sein.<br />
<br />
==Kapitel 4 - Der Shipmanager - Einführung==<br />
Nachdem wir nun über ein paar Grundlagen verfügen, wollen wir uns den wirklich interessanten Dingen zuwenden, der Steuerung von Spielinhalten durch Scripte.<br />
<br />
Um mit Schiffen zu interagieren gibt es eine Sammlung von Methoden, welche im Shipmanager zu finden sind.<br />
Hierzu müssen wir dem Shipmanager als erstes Mitteilen, welches bzw. welche Flotte er verwenden soll.<br />
<br />
Hierführ gibt es die Befehle:<br />
<pre><nowiki>Shipmanager.BenutzeSchiff(NCC-Nummer des Schiffes);</nowiki></pre><br />
bzw.<br />
<pre><nowiki>Shipmanager.BenutzeFlotte(ID der Flotte);</nowiki></pre><br />
<br />
Damit weiß der Shipmanager schonmal welches Schiff, bzw. welche Flotte die Aktionen ausführen soll.<br />
<br />
Mit dem Shipmanager können folgende Aktionen ausgeführt werden:<br />
*An- und Abdocken<br />
*Alarm Stufe ändern<br />
*Aus Flotten austreten<br />
*Aus Orbit einfliegen austreten <br />
*Benennen(Name As String)<br />
*Deuterium sammeln (Nur mit FP)<br />
*Erz sammeln (Nur mit FP)<br />
*Fliegen<br />
*Sensoren aktivieren / deaktivieren<br />
*Reparieren<br />
*Batterien entladen<br />
*Schilde aktivieren/deaktiviere/aufladen<br />
*Reservebatterie aufladen<br />
*Traktorstrahl ein- / ausschalten<br />
*Beamen<br />
*Verstecken<br />
*Replikator aktivieren/deaktivieren<br />
*Waren über Bord werfen<br />
*Warpkern aktiveren/deaktivieren<br />
*Wrackextraktoren<br />
<br />
Eine vollständige Auflistung aller Funktionen findet sich im [http://game.stne.net/ObjectExplorer.aspx?p=CShipManager Objekt-Explorer].<br />
<br />
Im folgenden wollen wir uns einige Funktionen genauer anschauen:<br />
===Beamen===<br />
kommt noch<br />
===Fliege===<br />
kommt noch<br />
===Schiffsystem nutzen===<br />
kommt noch<br />
<br />
==Autoren==<br />
(hier dürfen sich diejenigen verewigen die hier min. ein Kapitel geschrieben haben [sonst kommt noch einer daher nur weil er nen Rechtschreibfehler verbessert hat ;)])<br />
{|<br />
!Nickname<br />
!IG-id<br />
!Kapitel<br />
|-<br />
|WiZz4Rd<br />
|16475<br />
|Kapitel 1, Kapitel 2<br />
|-<br />
|Stryke<br />
|28885<br />
|Vorwort, Kapitel 3, Kapitel 4<br />
|-<br />
|[[Spieler:Xenon|Xenon]]<br />
|10127<br />
|Korrektur & Überarbeitung<br />
|}<br />
<br />
<br />
[[Kategorie:Scripting-Hilfe|Anfängerkurs]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:DatentypenScripting:Datentypen2006-06-23T12:32:57Z<p>Arakis: Konvertierungen hinzugefügt</p>
<hr />
<div>{{Scriptingmenue}}<br />
Dieser Artikel beinhaltet eine Auflistung sämtlicher Typen die eine Variable haben kann. (in Arbeit)<br />
<br />
{|<br />
!Name<br />
!Beschreibung<br />
!Umwandlung durch<br />
|-<br />
| Char<br />
| Zeichen<br />
| CChar()<br />
|-<br />
| String <br />
| Zeichenkette<br />
| CStr()<br />
|-<br />
| Integer<br />
| Ganze Zahl(32 Bit)<br />
| CInt()<br />
|-<br />
| Long<br />
| <br />
| CLng()<br />
|-<br />
| Double<br />
|<br />
| CDbl()<br />
|-<br />
| Short<br />
|<br />
| CShort()<br />
|-<br />
| Date<br />
|<br />
| CDate()<br />
|-<br />
| Boolean<br />
| <br />
| CBool()<br />
|-<br />
| Byte<br />
|<br />
| CByte()<br />
|-<br />
| (Array)<br />
| <br />
|<br />
|}</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:SyntaxScripting:Syntax2006-06-04T16:16:22Z<p>Arakis: </p>
<hr />
<div>{{Scriptingmenue}}<br />
<br><br />
=Allgemeines=<br />
* Bei Variablennamen wird grundsätzlich auf Groß- und Kleinschreibung geachtet.<br />
* Jeder Befehl muss durch ein ; abgeschlossen werden. Du kannst im Prinzip auch alle Befehle in eine Zeile schreiben. Das ; fungiert als Trenner.<br />
<br><br />
<br><br />
=Deklarieren von Variabeln=<br />
Variablen sind ähnlich wie Platzhalter. Variabeln können je nach Typ bestimmte Werte oder Zustände aufnehmen und wieder abgeben.<br />
<br />
'''var''' ''Variabelname'' '''As''' ''Typ''<br />
<br />
<pre><br />
var str as string;<br />
var num as integer = 5;<br />
</pre><br />
<br />
Zeichenketten: Werden in ' ODER " eingeschlossen. Wenn das Quote-Zeichen in String verwendet werden soll, einfach zwei mal schreiben.<br />
<br />
<pre><br />
var str as string = 'Schönes Wetter heute';<br />
var str2 as string = 'Karl''s Wurst';<br />
var str3 as string = "Karl's Wurst";<br />
</pre><br />
<br />
=Bedingungen=<br />
If-Bedingung: IF (Bedingung) {Wahr-Block} ELSE {Falsch-Block}<br />
<br />
<pre><br />
var IstSchön as boolean = true;<br />
if (IstSchön)<br />
{<br />
WriteLine('Das Wetter ist schön');<br />
}<br />
else<br />
{<br />
WriteLine('Heute mal nicht');<br />
}<br />
</pre><br />
<br />
Else + Block kann auch weggelassen werden:<br />
<br />
<pre><br />
if (IstSchön)<br />
{<br />
WriteLine('Das Wetter ist schön');<br />
}<br />
</pre><br />
<br />
Es ist auch möglich, im das Else mit Hilfe von "ELSEIF" direkt als neue Bedingung zu definieren:<br />
<br />
<pre><br />
var i as integer = 3;<br />
<br />
if (i=1)<br />
{<br />
WriteLine(i);<br />
}<br />
elseif (i=2)<br />
{<br />
WriteLine(i);<br />
}<br />
elseif (i=3)<br />
{<br />
WriteLine(i);<br />
}<br />
elseif (i=4)<br />
{<br />
WriteLine(i);<br />
}<br />
else<br />
{<br />
WriteLine("Keine Übereinstimmung gefunden.");<br />
}<br />
</pre><br />
<br />
=Schleifen=<br />
<br />
==While-Schleife==<br />
<br />
Mit While wird ein Codeblock so lange ausgeführt, wie eine Bedingung wahr ist. Die While-Schleife nennt sich auch auch Kopf-gesteuerte Schleife.<br />
<br />
Syntax: WHILE (Bedingung) {Auszuführender Code}<br />
<br />
<pre><br />
var i as integer=0;<br />
<br />
While (i < 3)<br />
{<br />
WriteLine(i);<br />
i = i + 1;<br />
}<br />
</pre><br />
<br />
==Do-Schleife==<br />
<br />
Die Do-Schleife ist ähnlich der While-Schleife, mit dem Unterschied, dass die Bedingung erst am Ende des Codeblocks ausgewertet wird, das heißt, dass der Codeblock also mindestens ausgeführt wird. Die Do-Schleife nennt sich auch Fuß-gesteuerte Schleife.<br />
<br />
Syntax: {Auszuführender Code} DO (Bedingung);<br />
<br />
<pre><br />
var i as integer=0;<br />
<br />
{<br />
WriteLine(i);<br />
i = i + 1;<br />
}<br />
Do (i < 3);<br />
</pre><br />
<br />
==For-Schleife==<br />
<br />
Die For-Schleife führt eine Codeblock so lange aus, bis eine bestimmte Anzahl von Durchläufen erreicht wurde. Die For-Schleife nennt sich auch Zähler-gesteuerte Schleife.<br />
<br />
Syntax:<br><br />
FOR (Zählervariable = Startwert TO Endwert) {Auszuführender Code}<br><br />
FOR (Zählervariable = Startwert TO Endwert STEP Schrittweite) {Auszuführender Code}<br />
<br />
<pre><br />
var i as integer;<br />
<br />
For (i = 0 To 9);<br />
{<br />
WriteLine(i);<br />
}<br />
<br />
For (i = 90 To 0 Step -10);<br />
{<br />
WriteLine(i);<br />
}<br />
</pre><br />
<br />
<br><br />
<br><br />
[[Kategorie:Scripting-Hilfe|Syntax]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:SyntaxScripting:Syntax2006-06-04T15:34:05Z<p>Arakis: </p>
<hr />
<div>{{Scriptingmenue}}<br />
<br><br />
==Allgemeines==<br />
* Bei Variablennamen wird grundsätzlich auf Groß- und Kleinschreibung geachtet.<br />
* Jeder Befehl muss durch ein ; abgeschlossen werden. Du kannst im Prinzip auch alle Befehle in eine Zeile schreiben. Das ; fungiert als Trenner.<br />
<br><br />
<br><br />
==Deklarieren von Variabeln==<br />
'''var''' ''Variabelname'' '''As''' ''Typ''<br />
<br />
<pre><nowiki>var str as string;<br />
var num as integer = 5;</nowiki></pre><br />
<br />
Zeichenketten: Werden in ' ODER " eingeschlossen. Wenn das Quote-Zeichen in String verwendet werden soll, einfach zwei mal schreiben.<br />
<pre><nowiki>var str as string = 'Schönes Wetter heute';<br />
var str2 as string = 'Karl''s Wurst';<br />
var str3 as string = "Karl's Wurst";</nowiki></pre><br />
<br />
==Bedingungen==<br />
If-Bedingung: IF (Bedingung) {Wahr-Block} ELSE {Falsch-Block}<br />
<pre><nowiki>var IstSchön as boolean = true;<br />
if (IstSchön)<br />
{<br />
WriteLine('Das Wetter ist schön');<br />
}<br />
else<br />
{<br />
WriteLine('Heute mal nicht');<br />
}</nowiki></pre><br />
<br />
Else + Block kann auch weggelassen werden:<br />
<br />
<pre><nowiki>if (IstSchön)<br />
{<br />
WriteLine('Das Wetter ist schön');<br />
}<br />
</nowiki></pre><br />
<br><br />
<br><br />
[[Kategorie:Scripting-Hilfe|Syntax]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:Deutsammeln(flotte)Scripting:Deutsammeln(flotte)2006-05-21T12:51:04Z<p>Arakis: </p>
<hr />
<div>{{Scriptingmenue}}<br />
<br />
=Deutsammeln per Flotte=<br />
==Das Skript==<br />
ShipManager.BenutzeFlotte(flottenid);<br />
VAR Cargoship AS NEW CMyShip(Lagerschiff)<br />
VAR Tankship AS NEW CMyShip(Tankschiff)<br />
VAR freeCargo AS int32<br />
VAR Energi AS int32<br />
VAR Ticks AS int32<br />
freeCargo = Cargoship.Lager.FreieKapazität<br />
Energi = Tankship.Energie<br />
writeline(freeCargo);<br />
writeline(Energi);<br />
IF(freeCargo<900)<br />
{<br />
writeline('Bitte etwas Lager auf Lager 1 Schaffen, das Deuterium kann nicht Transportiert werden!');<br />
}<br />
ELSE<br />
{<br />
IF(Energi=30)<br />
{<br />
ShipManager.Abdocken();<br />
ShipManager.DeuteriumSammeln(30);<br />
ShipManager.AndockenAn(264979);<br />
ShipManager.TransferiereZuSchiff(275244, 150, EBeamRessource.Deuterium);<br />
}<br />
ELSE<br />
{<br />
Ticks = ((30 - Energi) / 6)<br />
writeline('Leider ist noch nicht genügen Energie da, benötigt werden 30 vorhanden ist ' & Energi & ' Energie, du musst noch ' & Ticks & ' Ticks warten.');<br />
}<br />
}<br />
==Komentar==<br />
Das ganze Skript ist auf Sammeln mit 6 [[Indus]] in einem [[Deuterium-Nebel|dichten Deuteriumnebel]] und das Lagern auf einer [[Antares B]] zugeschnitten,außerdem sollte eine Basisvorhanden sein, über welche die Waren transferiert werden könnnen. Wenn z.B. mit Sunhawks gesammelt wird muss man<br />
IF(Energi=30)<br />
durch<br />
IF(Energi=40)<br />
ersetzten, außerdem muss der Wert beim Beamen erhöt werden.<br/><br />
Auch muss der Beam-Wert gesenkt werden wenn man nur in einem [[Deuterium-Nebel|dünnen Deuteriumnebel]] sammelt.<br />
<br />
<br />
[[Kategorie:Scripte]]</div>Arakishttps://wiki.stne.net/index.php?title=Scripting_Diskussion:Deutsammeln(flotte)Scripting Diskussion:Deutsammeln(flotte)2006-05-21T12:49:37Z<p>Arakis: </p>
<hr />
<div>Bitte in Zukunft die "Du"-Form verwenden und Quelltext einrücken. [[Spieler:Arakis|Arakis]] 14:49, 21. Mai 2006 (W. Europe Daylight Time)</div>Arakishttps://wiki.stne.net/index.php?title=Scripting_Diskussion:Deutsammeln(flotte)Scripting Diskussion:Deutsammeln(flotte)2006-05-21T12:48:45Z<p>Arakis: </p>
<hr />
<div>Bitte die "Du"-Form verwenden.</div>Arakishttps://wiki.stne.net/index.php?title=Scripting:BinarySearchScripting:BinarySearch2006-05-18T06:52:56Z<p>Arakis: /* Der ultimative Test */</p>
<hr />
<div>=Der BinarySearch=<br />
<br />
Er wird verwendet um sortierte Arrays (z.B. mit [[Scripting:BubbleSort|BubbleSort]] vorsortiert) nach einer Zahl zu durchsuchen.<br />
BinarySearch ist erheblich schneller wie ein Linearer Search, spart Ressourcen sowie Rechen- und Ausführungszeit.<br />
<br><br><br />
<b><font color="#FF0000">ACHTUNG!!!</font></b> Diese Funktion ist mit <u><b>array.binarysearch()</b></u> unnötig geworden! Bitte den Algorythmus wegen Performancegründen <b><font color="#FF0000">NICHT</font></b> auf Dauer nutzen und <b><u>nur für Lehrzwecke</u></b> einsetzten!<br />
<br><br><br />
Der Search ist so programmiert, dass der Array nicht kopiert werden muß, sondern lediglich ein Speicherverweis dazu hergestellt wird. Das Array, welches als Quelle dient, wird dabei nicht verändert.<br />
<br />
==Die Syntax==<br />
<br />
<b>BinarySearch</b> wird ganz einfach als <b>Methode</b> aufgerufen:<br />
<br />
BinarySearch(Verwendetes-Array,Länge-des-Array,Gesuchte-Zahl,SpeicherVariable);<br />
<br />
Die Methode ist <b>VOID</b> da eine andere Umsetzung zum Entwicklungszeitpunkt (Version 0.1 Pre Alpha) nocht nicht zur Verfügung stand!<br />
<br />
In der Variablen <b>SpeicherVariable</b> wird das Ergebnis, ein Wert <b>zwischen 0 und Länge-des-Array</b>, gespeichert.<br><br />
Sollte die gesuchte Zahl <b>nicht gefunden</b> werden, ist <b>SpeicherVariable</b> nach der Verarbeitung <b>-1</b>!<br />
<br />
<b>Hinweiß:</b> Es wurde ein Workarround benötigt, da das Vergleichen der Ausdrücke zum Entwicklungszeitpunkt nur einzeln und mit <b>"<"</b> sowie <b>">"</b> möglich war!<br />
<br />
==Der Algorythmus==<br />
<br />
Der ganze Algorythmus ist als Methode verwirklicht worden. Dies ermöglicht die unveränderte übernahme des Quellcodes, siehe unten.<br />
<br />
function BinarySearch(ByRef a as array, aSe as integer) as integer {<br />
var aG as integer;<br />
var aL as integer = a.Length;<br />
var p1 as integer=0;<br />
var p2 as integer=aL;<br />
var c as integer=0;<br />
<br />
While(true){<br />
aG=(p1+p2)/2;<br />
if(a[aG]<aSe){p1=aG;}<br />
if(a[aG]>aSe){p2=aG;}<br />
if(a[aG]=aSe){return aG}<br />
<br />
if(c>aL){return -1}<br />
c++;<br />
}<br />
<br />
return -1;<br />
}<br />
<br />
==Der ultimative Test==<br />
<br />
Um den Suchalgorythmus zu testen, könnt ihr beispielsweise folgendes schreiben:<br />
<br />
var arr[] as integer = { 2, 9, 14, 16, 39, 48, 52, 70, 89, 94 };<br />
var aSearch as integer = 29;<br />
var aGoal as integer = 0;<br />
<br />
WriteLine(' ');<br />
<br />
WriteLine('Suche nach Zahl ' & aSearch & '...');<br />
aGoal = BinarySearch(arr, aSearch);<br />
<br />
if(aGoal<0){<br />
WriteLine('Die gesuchte Zahl ' & aSearch & ' befindet sich nicht im angegebenen Array!');<br />
}<br />
else {<br />
WriteLine('Die gesuchte Zahl ' & aSearch & ' befindet sich an Position ' & aGoal & '!');<br />
}<br />
WriteLine(' '); <br />
<br />
aSearch = 39<br />
<br />
WriteLine('Suche nach Zahl ' & aSearch & '...');<br />
aGoal = BinarySearch(arr, aSearch);<br />
<br />
if(aGoal<0){<br />
WriteLine('Die gesuchte Zahl befindet sich nicht im angegebenen Array!');<br />
}<br />
else {<br />
WriteLine('Die gesuchte Zahl ' & aSearch & ' befindet sich an Position ' & aGoal & '!');<br />
}<br />
WriteLine(' ');<br />
<br />
==Der Erfolg==<br />
<br />
Script gestartet.<br />
<br />
Suche nach Zahl 29...<br />
Die gesuchte Zahl 29 befindet sich nicht im angegebenen Array!<br />
<br />
Suche nach Zahl 39...<br />
Die gesuchte Zahl 39 befindet sich an Position 4!<br />
<br />
Script beendet.<br />
<br />
<b>Anmerkung:</b> "Position 4" bedeutet natürlich Zahl 5, da für ein Array die Zahl 0 auch relevant ist. Es wird also ab 0 und nicht von 1 weg gezählt!<br />
<br />
Viel Spaß mit BinarySearch!<br />
<br />
MFG Proximo<br />
<br />
[[Kategorie:Scripting|BinarySearch]]</div>Arakis