Kapitel 6: Scripting

This site uses cookies. By continuing to browse this site, you are agreeing to our Cookie Policy.

  • Informationen zum Scripting für EMERGENCY 4.

    Table Of Contents

    In diesem Teil des Tutorials werden wir uns im Allgemeinen mit den Scripts befassen. Es werden keine Programmierkenntnisse benötigt, um Scripts anzupassen, jedoch sollte man sich die Kommentare hinter den Code-Zeilen genau durchlesen, um richtige Änderungen vorzunehmen. Wie bereits unter dem Punkt "Das erste Konzept" erwähnt, werden wir ein Startscript, ein einfaches Alarmierungsscript und ein Parkscript in die Modifikation einbauen.

    Das Start-Script

    Das Startscript wird zu Beginn des Freeplay, also unmittelbar nach Beendigung des Ladevorgangs ausgeführt. Da wir uns dafür entschieden haben, die Fahrzeuge direkt auf der Map zu platzieren, fällt hier ein automatisches Positionieren der Fahrzeuge weg.In unserem Script wird den Fahrzeugen nur eine Geschwindigkeit zugeordnet und einer Zahl des Codeblocks zugewiesen.Hier erst mal das Script:

    Source Code

    1. void Start()
    2. {
    3. //Block//Fahrzeuge////////////////////////////////////////////////////////////////////////////////
    4. VehicleList vl("Fahrzeug_1"); //Name des Fahrzeugs auf der Map if(vl.GetNumVehicles() == 0)
    5. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    6. else
    7. {
    8. Vehicle v(vl.GetVehicle(0));
    9. v.SetSpeed(10.0f); //Wert der Geschwindigkeit anpassen
    10. }
    11. //Block//Fahrzeuge////////////////////////////////////////////////////////////////////////////////
    12. //Bei weiteren Fahrzeugen Block kopieren und Werte auf das neue Fahrzeug anpassen
    14. //Block//Disponenten////////////////////////////////////////////////////////////////////////////////
    15. PersonList pl("Disponent_1");
    16. if(pl.GetNumPersons() == 0)
    17. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    18. else
    19. Game::AddToGroup(pl.GetPerson(0), 0); //Letzte Zahl gibt die Zahl im Codeblock an
    20. //0 entspricht Codeblock 1
    21. //1 entspricht Codeblock 2
    22. //2 entspricht Codeblock 3
    23. //...
    24. //Block//Disponenten////////////////////////////////////////////////////////////////////////////////
    25. //Bei weiteren Disponenten Block kopieren und Werte auf den neuen Disponenten anpassen
    26. };
    28. bool OnLoad()
    29. {
    30. Start();
    31. Process::Kill();
    32. return true;
    33. }
    Display All
    Wir ersparen uns an dieser Stelle das genauere Eingehen auf die Funktionsweise dieses relativ kurzen Scripts. Viel interessanter dagegen ist das Erweitern um weitere Fahrzeuge. Beginnen wir mit den drei Fahrzeugen der hauptamtlichen Wache: Dem ELW, der DLK und dem HLF.Im Editor wurde den Prototypen bereits die Information über die Anzahl der Sitzplätze gegeben und benötigte Commands zugewiesen. Jedoch kann im Editor nicht die Geschwindigkeit definiert werden, was aus diesem Grund das Startscript übernehmen wird.

    Fahrzeuge im Start-Script

    Hauptamtliche Wache

    Source Code

    1. VehicleList vl("ELW_Haupt"); //Name des ELW der hauptamtlichen Wache auf der Map
    2. if(vl.GetNumVehicles() == 0)
    3. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    4. else
    5. {
    6. Vehicle v(vl.GetVehicle(0));
    7. v.SetSpeed(12.0f); //Wert der Geschwindigkeit des ELW der hauptamtlichen Wache
    8. }
    10. VehicleList vl("DLK_Haupt"); //Name der DLK der hauptamtlichen Wache auf der Map
    11. if(vl.GetNumVehicles() == 0)
    12. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    13. else
    14. {
    15. Vehicle v(vl.GetVehicle(0));
    16. v.SetSpeed(9.0f); //Wert der Geschwindigkeit der DLK der hauptamtlichen Wache
    17. }
    19. VehicleList vl("HLF_Haupt"); //Name des HLF der hauptamtlichen Wache auf der Map
    20. if(vl.GetNumVehicles() == 0)
    21. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    22. else
    23. {
    24. Vehicle v(vl.GetVehicle(0));
    25. v.SetSpeed(10.0f); //Wert der Geschwindigkeit des HLF der hauptamtlichen Wache
    26. }
    Display All
    An dieser Stelle haben wir uns für die Geschwindigkeiten 12 für ELW, 9 für die DLK und 10 für das HLF entschieden. Natürlich kann an den Werten später noch rumgespielt werden. Viel wichtiger ist aber, dass die Namen im Script mit dem tatsächlichen Namen der Fahrzeuge übereinstimmen.

    Wache der Freiwilligen Feuerwehr
    Hier wenden wir das gleiche Vorgehen an, wie bei der Hauptamtlichen Feuerwache.

    Source Code

    1. VehicleList vl("MTW_FFW"); //Name des MTW der Freiwilligen Feuerwehr auf der Map
    2. if(vl.GetNumVehicles() == 0)
    3. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    4. else
    5. {
    6. Vehicle v(vl.GetVehicle(0));
    7. v.SetSpeed(12.0f); //Wert der Geschwindigkeit des MTW der Freiwilligen Feuerwehr
    8. }
    10. VehicleList vl("LF16_FFW"); //Name des LF der Freiwilligen Feuerwehr auf der Map
    11. if(vl.GetNumVehicles() == 0)
    12. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    13. else
    14. {
    15. Vehicle v(vl.GetVehicle(0));
    16. v.SetSpeed(8.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    17. }
    Display All
    Die Rettungswache
    Auch hier greifen wir auf die gleiche Systematik zurück.

    Source Code

    1. VehicleList vl("RTW1"); //Name des ersten RTW auf der Map
    2. if(vl.GetNumVehicles() == 0)
    3. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    4. else
    5. {
    6. Vehicle v(vl.GetVehicle(0));
    7. v.SetSpeed(11.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    8. }
    10. VehicleList vl("RTW2"); //Name des zweiten RTW auf der Map
    11. if(vl.GetNumVehicles() == 0)
    12. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    13. else
    14. {
    15. Vehicle v(vl.GetVehicle(0));
    16. v.SetSpeed(11.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    17. }
    19. VehicleList vl("NEF"); //Name des NEF auf der Map
    20. if(vl.GetNumVehicles() == 0)
    21. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    22. else
    23. {
    24. Vehicle v(vl.GetVehicle(0));
    25. v.SetSpeed(13.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    26. }
    Display All

    Disponenten im Start-Script

    Die Disponenten sind Personen, denen wir später im Editor die Alarmierungscommands (wird zu einem späteren Zeitpunkt noch behandelt) zuweisen werden. Wir werden drei verschiedene Disponenten verwenden. Der erste wird alle Zugalarmierungen beinhalten, der Zweite nur Feuerwehr und der Dritte nur Rettungsdienst.

    Source Code

    1. PersonList pl("Disponent_1"); //Name des ersten Disponenten
    2. if(pl.GetNumPersons() == 0)
    3. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    4. else
    5. Game::AddToGroup(pl.GetPerson(0), 0); //Disponent auf Codeblock 1
    7. PersonList pl("Disponent_2"); //Name des zweiten Disponenten
    8. if(pl.GetNumPersons() == 0)
    9. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    10. else
    11. Game::AddToGroup(pl.GetPerson(0), 1); //Disponent auf Codeblock 2
    13. PersonList pl("Disponent_3"); //Name des dritten Disponenten
    14. if(pl.GetNumPersons() == 0)
    15. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    16. else
    17. Game::AddToGroup(pl.GetPerson(0), 2); //Disponent auf Codeblock 3
    Display All

    Die Namen der Fahrzeuge und Personen im Script müssen mit den Namen der Objekte auf der Map übereinstimmen. Ansonsten kann es zu Fehlfunktionen kommen!



    Das fertige Start-Script

    Source Code

    1. void Start()
    2. {
    3. VehicleList vl("ELW_Haupt"); //Name des ELW der hauptamtlichen Wache auf der Map
    4. if(vl.GetNumVehicles() == 0)
    5. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    6. else
    7. {
    8. Vehicle v(vl.GetVehicle(0));
    9. v.SetSpeed(12.0f); //Wert der Geschwindigkeit des ELW der hauptamtlichen Wache
    10. }
    12. VehicleList vl("DLK_Haupt"); //Name der DLK der hauptamtlichen Wache auf der Map
    13. if(vl.GetNumVehicles() == 0)
    14. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    15. else
    16. {
    17. Vehicle v(vl.GetVehicle(0));
    18. v.SetSpeed(9.0f); //Wert der Geschwindigkeit der DLK der hauptamtlichen Wache
    19. }
    21. VehicleList vl("HLF_Haupt"); //Name des HLF der hauptamtlichen Wache auf der Map
    22. if(vl.GetNumVehicles() == 0)
    23. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    24. else
    25. {
    26. Vehicle v(vl.GetVehicle(0));
    27. v.SetSpeed(10.0f); //Wert der Geschwindigkeit des HLF der hauptamtlichen Wache
    28. }
    29. VehicleList vl("MTW_FFW"); //Name des MTW der Freiwilligen Feuerwehr auf der Map
    30. if(vl.GetNumVehicles() == 0)
    31. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    32. else
    33. {
    34. Vehicle v(vl.GetVehicle(0));
    35. v.SetSpeed(12.0f); //Wert der Geschwindigkeit des MTW der Freiwilligen Feuerwehr
    36. }
    38. VehicleList vl("LF16_FFW"); //Name des LF der Freiwilligen Feuerwehr auf der Map
    39. if(vl.GetNumVehicles() == 0)
    40. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    41. else
    42. {
    43. Vehicle v(vl.GetVehicle(0));
    44. v.SetSpeed(8.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    45. }
    46. VehicleList vl("RTW1"); //Name des ersten RTW auf der Map
    47. if(vl.GetNumVehicles() == 0)
    48. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    49. else
    50. {
    51. Vehicle v(vl.GetVehicle(0));
    52. v.SetSpeed(11.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    53. }
    55. VehicleList vl("RTW2"); //Name des zweiten RTW auf der Map
    56. if(vl.GetNumVehicles() == 0)
    57. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    58. else
    59. {
    60. Vehicle v(vl.GetVehicle(0));
    61. v.SetSpeed(11.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    62. }
    64. VehicleList vl("NEF"); //Name des NEF auf der Map
    65. if(vl.GetNumVehicles() == 0)
    66. System::Log("Fahrzeug nicht gefunden: %s", vl.GetVehicle(0)->GetName());
    67. else
    68. {
    69. Vehicle v(vl.GetVehicle(0));
    70. v.SetSpeed(13.0f); //Wert der Geschwindigkeit des LF der Freiwilligen Feuerwehr
    71. }
    72. PersonList pl("Disponent_1"); //Name des ersten Disponenten
    73. if(pl.GetNumPersons() == 0)
    74. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    75. else
    76. Game::AddToGroup(pl.GetPerson(0), 0); //Disponent auf Codeblock 1
    77. PersonList pl("Disponent_2"); //Name des zweiten Disponenten
    78. if(pl.GetNumPersons() == 0)
    79. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    80. else
    81. Game::AddToGroup(pl.GetPerson(0), 1); //Disponent auf Codeblock 2
    82. PersonList pl("Disponent_3"); //Name des dritten Disponenten
    83. if(pl.GetNumPersons() == 0)
    84. System::Log("Disponent nicht gefunden: %s", pl.GetPerson(0)->GetName());
    85. else
    86. Game::AddToGroup(pl.GetPerson(0), 2); //Disponent auf Codeblock 3
    87. };
    89. bool OnLoad()
    90. {
    91. Start();
    92. Process::Kill();
    93. return true;
    94. }
    Display All

    Sollte es bei Scripts zu einer Fehlermeldung oder sogar zu einem Absturz kommen und eine eigenständige Fehlerbehebung nicht möglich sein, besteht die Möglichkeit ein Thema im Bereich Scripting im EMERGENCY-Forum zu eröffnen. Um schnelle Hilfe zu bekommen, sollte jedoch das komplette Script und die Logfile, die sich im Hauptverzeichnis von EMERGENCY 4 befindet, in dem Thema zur Verfügung stellt werden.

    Diese Information betrifft alle Probleme im Bereich Scripting, nicht nur Probleme mit dem Startscript.



    Die Alarm-Scripts

    Ersten Disponenten erstellen

    Wie bereits erwähnt wurde, werden wir drei Disponenten verwenden. Der erste Disponent wird alle Arten von Zügen alarmieren können (Löschzug mit Personenschaden, Löschzug ohne Personenschade, dringende Türöffnung usw.).Über den zweiten Disponent werden alle Feuerwehrfahrzeuge gesondert alarmiert. Jedoch muss hier eine Unterscheidung zwischen hauptamtlichen Kräften und freiwilligen Kräften getroffen werden. Berufsfeuerwehrleute verbringen ihren Tag auf der Wache und müssen somit nicht von zu Hause an das Gerätehaus laufen.Der dritte Disponent wird nur die Alarm-Commands der Rettungsdienstfahrzeuge beinhalten. Da einsatzbereite Fahrzeuge des Rettungsdienst eigentlich immer mit Kräften besetzt sind, die sich vor Ort befinden, wird hier das gleiche System wie bei der hauptamtlichen Wache zum Einsatz kommen. Nachfolgend der Grundaufbau des Scripts - hier werden später noch Änderungen vorgenommen.

    Source Code

    1. const char ICON[] = "";
    2. const char CURSOR[] = "";
    3. const char VEHICLE_NAME[] = "";
    4. const char VIRTUAL_OBJECT[] = "";
    5. const char SOUND[] = "";
    6. const char MESSAGE[] = "";
    7. const char NUM_PERSON[] = "";
    8. const char PROTO_PERSON[] = "";
    10. float WAIT_PERSON = 5;
    11. float WAIT_VEHICLE = 20;
    13. bool vehiclefull = false;
    15. object Alarm_ELW : CommandScript
    16. {
    17. Alarm_ELW()
    18. {
    19. SetIcon(ICON);
    20. SetCursor(CURSOR);
    21. SetValidTargets(TARGET_STREET);
    22. SetValidTargets(TARGET_FLOOR);
    23. }
    25. bool CheckTarget(GameObject *Caller, Actor *Target, int childID)
    26. {
    27. return true;
    28. }
    30. void PushActions(GameObject *Caller, Actor *Target, int childID)
    31. {
    32. Vector APos = Game::GetCommandPos();
    33. VehicleList vl(VEHICLE_NAME);
    34. if(gol.GetNumObjects()==0)
    35. {
    36. System::Log("%s nicht gefunden", VEHICLE_NAME);
    37. return;
    38. }
    39. Vehicle v(vl.GetVehicle(0));
    41. ActorList al(VIRTUAL_OBJECT);
    42. if(al.GetNumActors()==0)
    43. {
    44. System::Log("%s nicht gefunden", VIRTUAL_OBJECT);
    45. return;
    46. }
    47. Vector SPos = al.GetActor(0)->GetPosition();
    49. v.SetUserData(1);
    51. Audio::PlaySample(SOUND);
    52. Mission::PlayHint(MESSAGE);
    54. for(int i = 1; i <= NUM_PERSON; i++)
    55. {
    56. Person p = Game::CreatePerson(PROTO_PERSON, "Unnamed");
    57. p.SetRole(ROLE_SQUAD);
    58. p.SetUpgradeLevel(3);
    59. Game::FindFreePosition(&p, spawnp, 100.f);
    60. p.SetPosition(SPos);
    61. p.PushActionShowHide(ACTION_NEWLIST, true);
    62. p.PushActionWait(ACTION_APPEND, WAIT_PERSON);
    63. p.PushActionShowHide(ACTION_APPEND, false);
    64. p.PushActionMove(ACTION_APPEND, v.GetPosition());
    65. p.PushActionEnterCar(ACTION_APPEND, &v);
    66. if(i == NUM_PERSON)
    67. vehiclefull = true;
    68. }
    70. if(vehiclefull)
    71. {
    72. v.PushActionWait(ACTION_NEWLIST, WAIT_VEHICLE);
    73. v.PushActionMove(ACTION_APPEND, Apos);
    74. }
    75. }
    76. };
    Display All

    Eigentlich muss an diesem Script nicht viel verändert werden. Änderungen sind nur im oberen Teil nötig. Das Script ist so aufgebaut, dass alle wichtigen Variablen, wie Ausrückedauer, Prototyp der Person, Fahrzeugname usw. in den ersten 8 Zeilen einfach abgeändert werden können.

    Weitere Disponenten erstellen

    Der dritte Disponent ist für die Kräfte des Rettungsdienstes zuständig. Wir beginnen also exemplarisch mit einem Rettungswagen.

    Source Code

    1. const char ICON[] = "RTW1";
    2. const char CURSOR[] = "RTW1";
    3. const char VEHICLE_NAME[] = "";
    4. const char VIRTUAL_OBJECT[] = "";
    5. const char SOUND[] = "";
    6. const char MESSAGE[] = "";
    7. const char NUM_PERSON[] = "";
    8. const char PROTO_PERSON[] = "";

    Die Variablen ICON und CURSOR sind die Namen derGrafiken , die in dem Bedienfeld der Personen oder Fahrzeuge auftauchen. Hier muss nur ein Name angegeben werden, da das Spiel die passenden Bilddateien automatisch aus dem Icon- und Cursor-Ordner bezieht.

    const char VEHICLE_NAME[] = "RTW1";

    Ähnlich wie be beim Script-Script, wird hier der Name des Fahrzeugs auf der Map festgelegt. Somit weiß das Spiel, zu welchem Fahrzeug die Personen bei einer Alarmierung laufen sollen.

    const char VIRTUAL_OBJECT[] = "Spawn_RTW1";

    Die Variable VIRTUAL_OBJECT ist der Name des virtuellen Objekts, an dem die Personen generiert (gespawnt) werden.

    Source Code

    1. const char SOUND[] = "mod:Audio/Alarm/Piepser.wav";
    2. const char MESSAGE[] = "Alarm für den Rettungswagen 1";
    An dieser Stelle hat man die Möglichkeit eine Sounddatei -zum Beispiel von einem Alarmgong oder einen Melder - abspielen zu lassen. Hierzu muss der Pfad zu einer .wav-Datei angegeben werden. Normalerweise werden Audiodateien im Ordner Audio hinterlegt, jedoch ist das ziemlich egal, solange der angegebene Pfad im Script korrekt angegeben ist.Bei der Variable Message kann ein Text eingegeben werden, der unmittelbar nach der Alarmierung in dem blauen Fenster am oberen Bildschirmrand als Laufschrift eingeblendet wird.

    Source Code

    1. const char NUM_PERSON[] = "2";
    2. const char PROTO_PERSON[] = "mod:Prototypes/Persons/Ambulance/paramedic.e4p";
    Hier wird die Anzahl der zu erstellenden Personen eingetragen. Bei einem RTW sind das im Normalfall zwei Personen. Darunter wird der Pfad zum Prototyp zur Personen, die erstellt werden sollen, angegeben.
    Dieser Prozess des Anpassens muss nun sowohl für den zweiten RTW, das NEF, den ELW, die DLK und das HLF der ständig besetzten Wache durchgeführt werden.

    Sollte bei einem späteren Test des Scripts auffallen, dass keine Personen gespawnt werden, ist zuerst die Richtigkeit des Pfades zu prüfen.

    202,049 times viewed