API:CBaseShipManager

Aus STNE-Wiki

(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
Zeile 35: Zeile 35:
!Methode !! Parameter !! Erklärung
!Methode !! Parameter !! Erklärung
|-
|-
-
|ActivateLRS(Status) || [[API:Boolean|Boolean]] || Bei Schiff.Action.ActivateLRS(True) wird das LRS aktiviert, bei "False" deaktiviert
+
|ActivateLRS(Status) || [[API:Boolean|Boolean]] || Bei Schiff.Action.ActivateLRS([[code|True]]) wird das LRS aktiviert, bei [[code|False]] deaktiviert
|-
|-
|ActivateReplicators(Status) || [[API:Boolean|Boolean]] || Aktiviert/Deaktiviert den Replikator an Bord
|ActivateReplicators(Status) || [[API:Boolean|Boolean]] || Aktiviert/Deaktiviert den Replikator an Bord
Zeile 43: Zeile 43:
|ActivateSRS(Status) || [[API:Boolean|Boolean]] || SRS aktivieren
|ActivateSRS(Status) || [[API:Boolean|Boolean]] || SRS aktivieren
|-
|-
-
|ActivateTractorBeam(ShipID) || [[API:Integer|Integer]] || Erfasst das Schiff mit der NCC-Nr "ShipID" im Traktorstrahl
+
|ActivateTractorBeam(ShipID) || [[API:Integer|Integer]] || Erfasst das Schiff mit der NCC-Nr [[code|ShipID]] im Traktorstrahl
|-
|-
|ActivateWarpCore(Status) || [[API:Boolean|Boolean]] || Warpkern aktivieren
|ActivateWarpCore(Status) || [[API:Boolean|Boolean]] || Warpkern aktivieren
|-
|-
-
|ApplyGoodsToConstruction() || - || Speißt beim Umbau von Tugs / Stationen die Waren ein
+
|ApplyGoodsToConstruction() || - || Speist beim Umbau von Tugs / Stationen die Waren ein
|-
|-
-
|ChargeEmergencyBattery(ShipID, Menge) || [[API:Integer|Integer]], [[API:Integer|Integer]] || Lädt die Reservebatterie von dem Schiff mit der NCC-Nr "ShipID" um "Menge" Energieeinheiten
+
|ChargeEmergencyBattery(ShipID, Menge) || [[API:Integer|Integer]], [[API:Integer|Integer]] || Lädt die Reservebatterie von dem Schiff mit der NCC-Nr [[code|ShipID]] um [[code|Menge]] Energieeinheiten
|-
|-
-
|ChargeShields(Menge) || [[API:Integer|Integer]] || Lädt die eigenen Schilde um "Menge" auf.
+
|ChargeShields(Menge) || [[API:Integer|Integer]] || Lädt die eigenen Schilde um [[code|Menge]] auf.
|-
|-
-
|CollectDeuterium(Energie) ** || [[API:Integer|Integer]] || Sammelt mit "Energie" Einheiten Deuterium
+
|CollectDeuterium(Energie) ** || [[API:Integer|Integer]] || Sammelt mit [[code|Energie]] Einheiten Deuterium
|-
|-
-
|CollectOre(Energie) ** || [[API:Integer|Integer]] || Extrahiert mit "Energie" Einheiten Erz
+
|CollectOre(Energie) ** || [[API:Integer|Integer]] || Extrahiert mit [[code|Energie]] Einheiten Erz
|-
|-
|DeactivateTractorBeam() || - || Deaktiviert den Traktorstrahl, in dem ein andere Schiff gehalten wird.
|DeactivateTractorBeam() || - || Deaktiviert den Traktorstrahl, in dem ein andere Schiff gehalten wird.
|-
|-
-
|DischargeEmergencyBattery(Menge) || [[API:Integer|Integer]] || Entlädt die Reservebatterie um "Menge"
+
|DischargeEmergencyBattery(Menge) || [[API:Integer|Integer]] || Entlädt die Reservebatterie um [[code|Meng]]e
|-
|-
-
|DockTo(ShipID) || [[API:Integer|Integer]] || Dockt an das Schiff/Station mit der NCC-Nr "ShipID" an
+
|DockTo(ShipID) || [[API:Integer|Integer]] || Dockt an das Schiff/Station mit der NCC-Nr [[code|ShipID]] an
|-
|-
|EnterOrbit || - || Betritt den Orbit der Kolonie, über der das Schiff gerade steht
|EnterOrbit || - || Betritt den Orbit der Kolonie, über der das Schiff gerade steht
|-
|-
-
| ExtractFromWreck(Menge) || [[API:Integer|Integer]] || Extrahiert Duranium aus dem erfassten Wrack mit Energiemenge "Menge"
+
| ExtractFromWreck(Menge) || [[API:Integer|Integer]] || Extrahiert Duranium aus dem erfassten Wrack mit Energiemenge [[code|Meng]]e
|-
|-
-
| Fly(AnzahlFelder, Richtung) || [[API:Integer|Integer]], [[API:EShipDirection|EShipDirection]] || Fliegt "AnzahlFelder" in die vorgegebene "Richtung"
+
| Fly(AnzahlFelder, Richtung) || [[API:Integer|Integer]], [[API:EShipDirection|EShipDirection]] || Fliegt [[code|AnzahlFelder]] in die vorgegebene [[code|Richtun]]g
|-  
|-  
-
| FlyTo(Position) ** || [[API:String|String]] || Fliegt zu der angegeben Positon im Format 'x|y'
+
| FlyTo(Position) ** || [[API:String|String]] || Fliegt zu der angegeben Positon im Format [[code|"x|y"]]
|-
|-
| Hide(Versteckt) || [[API:Boolean|Boolean]] || Versteckt das Schiff (wenn es sich in einem dichten Nebel/Asteroiden befindet)
| Hide(Versteckt) || [[API:Boolean|Boolean]] || Versteckt das Schiff (wenn es sich in einem dichten Nebel/Asteroiden befindet)
Zeile 79: Zeile 79:
| LeaveOrbit() || - || Verlässt den aktuellen Orbit
| LeaveOrbit() || - || Verlässt den aktuellen Orbit
|-
|-
-
| RefillWarpCore(Menge) || [[API:Integer|Integer]] || Lädt "Menge" Warpkernfüllungen auf
+
| RefillWarpCore(Menge) || [[API:Integer|Integer]] || Lädt [[code|Menge]] Warpkernfüllungen auf
|-
|-
-
| Repair(ShipID, Hüllenpunkte) || [[API:Integer|Integer]], [[API:Integer|Integer]] || Repariert das Schiff mit der NCC-Nr "ShipID" um "Hüllenpunkte" Punkte
+
| Repair(ShipID, Hüllenpunkte) || [[API:Integer|Integer]], [[API:Integer|Integer]] || Repariert das Schiff mit der NCC-Nr [[code|ShipID]] um [[code|Hüllenpunkte]] Punkte
|-
|-
| SetAlertLevel(Stufe) || [[API:EAlertLevel|EAlertLevel]] || Setzt die Alarmstufe auf den gegeben Wert vom Typ [[API:EAlertLevel|EAlertLevel]]
| SetAlertLevel(Stufe) || [[API:EAlertLevel|EAlertLevel]] || Setzt die Alarmstufe auf den gegeben Wert vom Typ [[API:EAlertLevel|EAlertLevel]]
Zeile 87: Zeile 87:
| SetName(Name) || [[API:String|String]] || Benennt das Schiff um
| SetName(Name) || [[API:String|String]] || Benennt das Schiff um
|-
|-
-
| TransferFromColony(KolonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Transportiert von Kolonie mit der ID "KolonieID" genau "Anzahl" Ressourcem vom Typ "Ressource" ([[API:EBeamResource|EBeamResource]])
+
| TransferFromColony(KolonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Transportiert von Kolonie mit der ID [[code|KolonieID]] genau [[code|Anzahl]] Ressourcem vom Typ [[code|Ressource]] ([[API:EBeamResource|EBeamResource]])
|-
|-
-
| TransferFromShip(FromShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Transportiert Waren von einem Schiff mit der NCC-Nr "FromShipID"
+
| TransferFromShip(ShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Transportiert Waren von einem Schiff mit der NCC-Nr [[code|FromShipI]]D
|-
|-
-
| TransferToColony(ToColonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Warentransport zur Kolonieei
+
| TransferToColony(KolonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Warentransport zur Kolonie
|-
|-
-
| TransferToShip(ToShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Warentransport zu einem Schiff
+
| TransferToShip(ShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Warentransport zu einem Schiff
|-
|-
| Undock() || - || Das Schiff abdocken
| Undock() || - || Das Schiff abdocken
|}
|}
 +
  ** Nur mit Feature-Pack möglich
  ** Nur mit Feature-Pack möglich

Version vom 20. August 2010, 12:58 Uhr

fertige Scripte | Anleitungen und FAQ | Überblick über die Scripting-Sektion | API-Übersicht | Hilfen zum Arbeiten im Wiki

Die Klasse CBaseShipManger wird benötigt um Aktionen mit einem Schiff durchzuführen.

Hierzu ist es erstmal notwendig, eine Instanz von CMyShip zu erzeugen:

Var Schiff As New CMyShip(123456);

Auf das Schiff mit der NCC 123456 kann man nun sämtliche Methoden des Objektes CBaseShipManger anwenden, da die Eigenschaft Action von CMyShip der Klasse CBaseShipManager entspricht.

Hier ein kleines Beispiel:

 Var Schiff As New CMyShip(123456);
 Var Station As New CMyShip(54321);
 Schiff.Action.CollectOre(20);
 Schiff.Action.FlyTo("150|250");
 Schiff.Action.EnterOrbit();
 Schiff.Action.DockTo(Station.ShipID);
 Schiff.Action.TransferToShip(Station.ShipID, 100, EBeamResource.IridiumOre);
 Schiff.Action.TransferFromShip(Station.ShipID, 50, EBeamResource.Deuterium);
 Schiff.Action.TransferFromShip(54321, 50, EBeamRessource.Food);
 Schiff.Action.Undock();
 Schiff.Action.LeaveOrbit();
 Schiff.Action.FlyTo("152|251");

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.

Hier eine Liste der gebräuchlichen Methoden von CBaseShipManager:

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.

 WICHTIG: Bevor du Aktionen ausführst, prüfe erst ob diese Möglich ist, z.B. beim Beamen oder SRS aktivieren - sonst wird unnötiger Code ausgeführt und ggf. ein Kampftick berechnet (auch wenn keine feindlichen Schiffe vorhanden sind. Bitte bedenke dass dein Skript maximal 100 Aktionen pro Durchlauf ausführen kann, also achte nicht nur dem Server zu Liebe auf Performance!
Methode Parameter Erklärung
ActivateLRS(Status) Boolean Bei Schiff.Action.ActivateLRS(True) wird das LRS aktiviert, bei False deaktiviert
ActivateReplicators(Status) Boolean Aktiviert/Deaktiviert den Replikator an Bord
ActivateShields(Status) Boolean Schilde aktivieren
ActivateSRS(Status) Boolean SRS aktivieren
ActivateTractorBeam(ShipID) Integer Erfasst das Schiff mit der NCC-Nr ShipID im Traktorstrahl
ActivateWarpCore(Status) Boolean Warpkern aktivieren
ApplyGoodsToConstruction() - Speist beim Umbau von Tugs / Stationen die Waren ein
ChargeEmergencyBattery(ShipID, Menge) Integer, Integer Lädt die Reservebatterie von dem Schiff mit der NCC-Nr ShipID um Menge Energieeinheiten
ChargeShields(Menge) Integer Lädt die eigenen Schilde um Menge auf.
CollectDeuterium(Energie) ** Integer Sammelt mit Energie Einheiten Deuterium
CollectOre(Energie) ** Integer Extrahiert mit Energie Einheiten Erz
DeactivateTractorBeam() - Deaktiviert den Traktorstrahl, in dem ein andere Schiff gehalten wird.
DischargeEmergencyBattery(Menge) Integer Entlädt die Reservebatterie um Menge
DockTo(ShipID) Integer Dockt an das Schiff/Station mit der NCC-Nr ShipID an
EnterOrbit - Betritt den Orbit der Kolonie, über der das Schiff gerade steht
ExtractFromWreck(Menge) Integer Extrahiert Duranium aus dem erfassten Wrack mit Energiemenge Menge
Fly(AnzahlFelder, Richtung) Integer, EShipDirection Fliegt AnzahlFelder in die vorgegebene Richtung
FlyTo(Position) ** String Fliegt zu der angegeben Positon im Format "x|y"
Hide(Versteckt) Boolean Versteckt das Schiff (wenn es sich in einem dichten Nebel/Asteroiden befindet)
JettisonGoods(Menge, WarenTyp) Integer, EGoodsType Waren über Board werfen
LeaveAllFleets() - Verlässt alle Flotten, in denen das Schiff zugeteilt wurde
LeaveOrbit() - Verlässt den aktuellen Orbit
RefillWarpCore(Menge) Integer Lädt Menge Warpkernfüllungen auf
Repair(ShipID, Hüllenpunkte) Integer, Integer Repariert das Schiff mit der NCC-Nr ShipID um Hüllenpunkte Punkte
SetAlertLevel(Stufe) EAlertLevel Setzt die Alarmstufe auf den gegeben Wert vom Typ EAlertLevel
SetName(Name) String Benennt das Schiff um
TransferFromColony(KolonieID, Anzahl, Ressource) Integer, Integer, EBeamResource Transportiert von Kolonie mit der ID KolonieID genau Anzahl Ressourcem vom Typ Ressource (EBeamResource)
TransferFromShip(ShipID, Anzahl, Ressource) Integer, Integer, EBeamResource Transportiert Waren von einem Schiff mit der NCC-Nr FromShipID
TransferToColony(KolonieID, Anzahl, Ressource) Integer, Integer, EBeamResource Warentransport zur Kolonie
TransferToShip(ShipID, Anzahl, Ressource) Integer, Integer, EBeamResource Warentransport zu einem Schiff
Undock() - Das Schiff abdocken


** Nur mit Feature-Pack möglich