API:CBaseShipManager

Aus STNE-Wiki

(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: „Die Klasse CBaseShipManger wird benötigt um Aktionen mit einem Schiff durchzuführen. Hierzu ist es erstmal notwendig, eine Instanz von…“)
K
 
(Der Versionsvergleich bezieht 11 dazwischenliegende Versionen mit ein.)
Zeile 1: Zeile 1:
 +
{{Vorlage:ApiMenu}}
 +
 +
== Allgemein ==
Die Klasse [[API:CBaseShipManager|CBaseShipManger]] wird benötigt um Aktionen mit einem Schiff durchzuführen.
Die Klasse [[API:CBaseShipManager|CBaseShipManger]] wird benötigt um Aktionen mit einem Schiff durchzuführen.
Hierzu ist es erstmal notwendig, eine Instanz von [[API:CMyShip|CMyShip]] zu erzeugen:
Hierzu ist es erstmal notwendig, eine Instanz von [[API:CMyShip|CMyShip]] zu erzeugen:
-
[[code|Var Schiff As New CMyShip(123456);]]
+
{{code|Var Schiff As New CMyShip(123456);}}
-
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.
+
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.
-
Hier ein kleines Beispiel:
+
== Beispiel ==
   Var Schiff As New CMyShip(123456);
   Var Schiff As New CMyShip(123456);
Zeile 25: Zeile 28:
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.
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 [[API:CBaseShipManager:CBaseShipManager]]:
+
== Methoden ==
 +
 
 +
Hier eine Liste der gebräuchlichen Methoden von [[API:CBaseShipManager|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.''
''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!
{|
{|
Zeile 34: Zeile 42:
!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 42: Zeile 50:
|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|Menge}
|-
|-
-
|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
|-
|-
-
| colspan="3" Weitere Methoden folgen...
+
| ExtractFromWreck(Menge) || [[API:Integer|Integer]] || Extrahiert Duranium aus dem erfassten Wrack mit Energiemenge {{code|Menge}}
 +
|-
 +
| Fly(AnzahlFelder, Richtung) || [[API:Integer|Integer]], [[API:EShipDirection|EShipDirection]] || Fliegt {{code|AnzahlFelder}} in die vorgegebene {{code|Richtung}}
 +
|-
 +
| 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)
 +
|-
 +
| JettisonGoods(Menge, WarenTyp) || [[API:Integer|Integer]], [[API:EGoodsType|EGoodsType]] || Waren über Board werfen
 +
|-
 +
| LeaveAllFleets() || - || Verlässt alle Flotten, in denen das Schiff zugeteilt wurde
 +
|-
 +
| LeaveOrbit() || - || Verlässt den aktuellen Orbit
 +
|-
 +
| 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 {{code|ShipID}} um {{code|Hüllenpunkte}} Punkte
 +
|-
 +
| SetAlertLevel(Stufe) || [[API:EAlertLevel|EAlertLevel]] || Setzt die Alarmstufe auf den gegeben Wert vom Typ [[API:EAlertLevel|EAlertLevel]]
 +
|-
 +
| 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 {{code|KolonieID}} genau {{code|Anzahl}} Ressourcem vom Typ {{code|Ressource}} ([[API:EBeamResource|EBeamResource]])
 +
|-
 +
| TransferFromShip(ShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Transportiert Waren von einem Schiff mit der NCC-Nr {{code|FromShipID}}
 +
|-
 +
| TransferToColony(KolonieID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Warentransport zur Kolonie
 +
|-
 +
| TransferToShip(ShipID, Anzahl, Ressource) || [[API:Integer|Integer]], [[API:Integer|Integer]], [[API:EBeamResource|EBeamResource]] || Warentransport zu einem Schiff
 +
|-
 +
| Undock() || - || Das Schiff abdocken
|}
|}
 +
 +
 +
** Nur mit Feature-Pack möglich
 +
 +
http://game.stne.net/ObjectExplorer.aspx?p=CBaseShipManager

Aktuelle Version vom 20. August 2010, 18:21 Uhr

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

Allgemein

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.

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.

Methoden

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 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

http://game.stne.net/ObjectExplorer.aspx?p=CBaseShipManager

Von „https://wiki.stne.net/index.php?title=API:CBaseShipManager“
Starflyer - Wikizeitung