Editing Wiki

Bitte bearbeite dieses Dokument nur, wenn du es verbessern kannst.

Nach dem Bearbeiten den [Speichern]-Knopf drücken. Siehe Formatting Syntax zur Wiki-Syntax. Zum Testen bitte erst im Spielplatz üben.

====== oCTriggerScript ======

===== 1. TimeLoop =====

Wir beginnen mit einer ganz gewöhnlichen Zeitschleife. Wozu dient eine Zeitschleife?:
   * In der Zeitschleife kann zum Beispiel abgefragt werden, ob der Spieler ein bestimmtes Item besitzt, da die Zeitschleife in wiederkehrenden Abständen, (Intervall einstellbar) durchliest, was in diesem Script alles eingetragen ist oder abgefragt werden soll.

* Ein TimeLoop lässt sich auch mit **LeGo** erstellen [[http://forum.worldofplayers.de/forum/threads/1408430-Skriptpaket-LeGo-3]]

* Kenntnisse, wie man im Spacer z.B Vobs in die Welt setzt. -> [[spacer:vobs:allgemein|]].\\ 
  * Wie man diese Objekte im Spacer bewegt, zum platzieren, -> [[spacer:vobs:allgemein#vobs_bewegen_und_rotieren|]]\\
  * wären von Vorteil!

* ** Wir starten den Spacer und öffnen die zu bearbeitende *.ZEN**
    * Wir nehmen uns das Objekt**Pages**Fenster vor, setzen einen Haken bei "Hold" und stellen jetzt die Zeit auf etwa 12:00. Jetzt wird es, egal wie lange wir arbeiten, nicht regnen im Spacer und auch nicht dunkel werden. 12:00 habe ich gewählt, weil es da eigentlich am hellsten sein müsste. 
{{:quickstart:spacer:timehold.jpg|}}
==== 1.1 Einsetzen TriggerScript ====

* Wir wenden uns dem Objektfenster zu und klicken uns durch den Pfad -> zCVob -> zCTriggerBase(abstract) -> -> zCTrigger -> ocTriggerScript
{{:quickstart:octrig_01.jpg|pic_01}}

* Wir klicken mit der rechten Maustaste in das Spacer Hauptfenster und erhalten das Vob-Fenster mit der Option "Insert(oCTriggerScript)"
{{:quickstart:octrig_02.jpg|}}
  * Wir klicken auf "Insert(oCTriggerScript)" und erhalten einen "grauen Würfel" - ein Koordinaten-Kreuz welches "oCTriggerScript" benannt ist.
{{:quickstart:octrig_03.jpg|}}

* Wir geben unserem oCTriggerScript einen Namen mit Bezug. In unserem Falle TS_TIMELOOP_05
  * TS = TRIGGERSCRIPT - TIMELOOP = ZEITSCHLEIFE - 05 = 0.5sec (Intervall der Abfrage)
    * vobName:TS_TIMELOOP_05 (IN GROSSBUCHSTABEN)
{{:quickstart:octrig_04.jpg|}}

==== 1.2 Einstellen TriggerScript ====

Dieser ocTriggerScript benötigt weder ein Visual, noch Kollision. Also belassen wir nachfolgende 4 Einträge unverändert
  * visual:(ohne Eintag)
  * cdStatic:FALSE (Kollision gegen statische Vobs)
  * cdDyn:FALSE (Kollision gegen dynamische Vobs)
  * staticVob:FALSE (ob das Objekt in die Lichtberechnung einbezogen wird)

*Vorerst wenden wir uns jetzt den Einstellungen des Objektfenster im Ordner "Trigger" zu
  ***Trigger**
    ***ActivationFilter**
        *__reactOnTrigger__:TRUE (Muss so bleiben, sonst reagiert der oCTriggerList nicht mehr auf Aufrufe, Script oder Direktlink im Spacer)
        *__reactOnTouch__:TRUE (Hat keine Auswirkungen bei unserer Beispielschleife, egal ob der Eintrag FALSE, oder TRUE heisst) 
        *__reactOnDamage__:TRUE (Funktioniert nur mit Bogen und Armbrust, aber in unserem Falle auch nicht, da wir die Kollision ausgeschaltet haben.
        *__respondToObject__:TRUE (Ein Trigger reagiert zwar nicht auf die Berührung mit Objekten, habe noch nie diese Situation herbeiführen können, wenn man das aber, auf FALSE stellt, dann läuft zum Bsp. ein Mover, der angesteuert wird, nicht mehr an. Wir belassen das auf TRUE)
        *respondToPC:TRUE (Trigger reagiert zwar auf PC/Hero, aber nicht in unserem Falle, da wir die Kollision ausgeschaltet haben)
        *__respondToNPC__:TRUE (Trigger reagiert zwar auf NPC, aber nicht in unserem Falle, da wir die Kollision ausgeschaltet haben)
        *__startEnabled__:TRUE (Wenn das auf "FALSE" steht reagiert der oCTriggerscript nicht mehr)
        *__respondToVobName__: (ohne Eintrag)
        *__numCanBeActivated__:-1 (unendlich oft, 1 wäre 1x, 10 wäre 10x, 0 = aus/gar nicht)
        *__retriggerWaitSec__:0 (Wartezeit bis zur nächsten Auslösung in sec)
        *__damageTreshhold__:0  (? habe ich noch nie benutzt)
    ***FireBehavior**
        *fireDelaySec:0.5 (Hier tragen wir unsere 1/2 Sekunde ein, denn unser TimeLoop soll alle 0.5sec aufgerufen werden. __Wichtig__ = 0.5 -> **NULL_PUNKT_Fünf, nicht Komma**)
        *sendUntrigger:TRUE
   *scriptFunc:MY_TIMELOOP (GROSSBUCHSTABEN)

Hier das komplette Objektfenster mit den Einstellungen für einen funktionierenden TimeLoop

==== 1.3 TimeLoop Test ====

* Wir benötigen einen Eintrag in der __Startup.d__ um den TimeLoop bei Gamestart zu aktivieren

<code>

Wld_SendTrigger("TS_TIMELOOP_05");

</code>
 
  *Dazu erstellen wir ein Script. In dieses Script könnt ihr später alle eure Abfragen reinpacken  Wir setzen jetzt lediglich einen Print in die Schleife um die Funktion zu prüfen.

<code>
func void MY_TIMELOOP() // Scriptfunc des oCTriggerScript
{
  PRINT("TEST SCHLEIFE");
  
  
Wld_SendTrigger("TS_TIMELOOP_05"); // Am Ende des TimeLoop ruft die   
};                                 // Zeitschleife sich selbst wieder auf
</code>

*Wenn wir jetzt das Game starten und die Testprints werden gedruckt, dann haben wir alles richtig gemacht.
{{:quickstart:octrig_07.jpg|}}

===== 2. Trigger Touch =====

*Wie schon der Name sagt, ist das der oCTriggerScript, der berührt werden muss,
  *Das kann mit einem Pfeil oder Bolzen ausgelöst werden wenn man den Trigger beschiesst -> [[quickstart:spacer:mobsplatzieren:ocmobswitch#switch_mit_fkw_beschiessen|]] 
  *oder ein NPC/PC muss den oCTriggerScript berühren.

* Wir haben z.B eine Pendelklingenfalle, die der Hero bei Annäherung an die Pendelklingen auslösen soll. Wer diese nachbauen will, oder nicht kennt, der kann sich hier informieren -> [[quickstart:spacer:mover2|]]
  * Da gibt es auch mehrere Möglichkeiten das bei Annäherung auszulösen:
  * Wir setzen einen Waypoint und schreiben in das Script unseres TimeLoop´s -> [[quickstart:triggerscript#timeloop|]] 
    
<code>
var int aufruf;
func void MY_TIMELOOP() // Scriptfunc des oCTriggerScript
{
  if (Npc_GetDistToWP (PC_Hero, "WP_FALLE")< 800) // kleiner 8m
  && (aufruf == 0)
  {
     Wld_SendTrigger("NAME");
     aufruf = 1;
  };
  
  Wld_SendTrigger("TS_TIMELOOP_05");// Am Ende des TimeLoop ruft die   
};                                  // Zeitschleife sich selbst wieder auf
</code>

* oder ihr setzt beim oCTriggerScript den Eintrag "numCanBeActivated:1", dann kann der oCTriggerScript nur 1x ausgelöst werden und ihr benötigt nicht die Variable "aufruf".

* oder wir setzen in angemessener Entfernung von der Falle eine Triggerbox, in die der NPC reinlatschen muss um den oCTriggerScript auszulösen.
 
  *2.1 Wir setzen uns einen oCTriggerScript, wie unter 1.1 beschrieben -> [[quickstart:triggerscript#einsetzen_triggerscript|]]

*2.2 Wir geben dem oCTriggerScript einen vobName:FALLESTART

*2.3 Wir klicken im Objektfenster auf die Zeile "Edit the Box"
{{:quickstart:octrig_08.jpg|}}

*2.4 und danach auf den Button "Define"
{{:quickstart:octrig_09.jpg|}}

*2.5 und erhalten das BoundingBox-GrössenEinstellfenster
{{:quickstart:octrig_10.jpg|}}

*2.6 Da ich weiss, dass mein Flur 4,8m breit ist gebe ich für "X" 480 ein. Ihr müsst halt probieren, bis dass die BoundingBox des oCTriggerScript die Breite eures Raumes einnimmt. Für die Höhe "Y" habe ich 150cm gewählt, damit der Hero nicht darüber springen kann und die Tiefe "Z" 50cm. Wenn die Boundingbox zu dünn ist, löst sie unter Umständen nicht aus.
{{:quickstart:octrig_11.jpg|}}

*2.7 Wir klicken auf "OK" und anschliessend auf den Button Stop

*2.8 Wir stellen numCanBeActivated:1 (kann nur einmal ausgelöst werden), oder wir belassen das auf -1 (unendlich) und sperren weitere Auslösungen per Script.

*2.9 Einstellung cdDyn:TRUE Wenn der Player nicht mit der Box kollidieren kann, dann spricht sie nicht an.

Jetzt gibt es nur noch das Problem, dass an solch einer TriggerBox Pfeile und Bolzen abprallen. Ein Problem das wir lösen könnten, wenn wir die Triggerbox breitflächig anlegen, so dass man ebenfalls nicht drüber springen kann und extrem flach, ca 20 cm, was dem Bogenschiessen ja keinen Abbruch tut.
{{:quickstart:octrig_12.jpg|}}

... oder aber ihr strebt eine Lösung mit Ikarus an -> [[http://forum.worldofplayers.de/forum/threads/1299679-Skriptpaket-Ikarus-4]]

*2.10 Fassen wir mal zusammen. Damit ein oCTriggerScript reagiert, wenn der Hero in die BoundingBox läuft, die BoundinBox berührt oder von einer sich bewegenden BoundingBox berührt wird, müssen folgende Voraussetzungen erfüllt sein: __Das sind jetzt nur die Einstellungen die verändert werden müssen__
    *VobName:NAME_TRIGGER
    *cdDyn:TRUE
    *respondToPC:TRUE (so belassen)
    *respondToNPC:FALSE (es sei denn, der Trigger soll auch auf alle anderen NPC reagieren)
    *numCanBeActivated:alles ausser Null
    *fireDelaySec:Verzögerung kann man einstellen wenn man das benötigt
    *scriptFunc:Um ein Script aufzurufen, wo dann reguliert wird, was geschehen soll.

*triggerTarget: könnt ihr nutzen, wenn ihr im Spacer direkt auf ein anderes Objekt, wie z.B. Mover, TriggerList, MoverControler usw. verlinken wollt. Ihr erhaltet dann im Spacer immer eine"Blaue Linie" zwischen den verlinkten Objekten.

==== 2.A Mobiler Schadenstrigger ====

Für unsere Pendelbeilfalle -> [[quickstart:spacer:mover2|]] benötigen wir jetzt noch die Auslösung, damit ein NPC/PC, der von der Beilklinge berührt wird einen Schaden erleidet.

*Wir klicken auf den Mover (eine von den Beilklingen)und anschliessend auf die Taste "M" und stellen die Beilklinge senkrecht. (jetzt nicht mehr mit der linken Maustaste auf den Mover klicken, sonst springt der zurück in seine Ausgangsstellung)
{{:quickstart:octrig_13.jpg|}}

*Wir klicken im Objektfenster auf "Create" und wählen dort den Eintrag "oCTriggerScript"
  *Wir klicken auf eine leere Stelle im Spacer Hauptfenster (**linke Maustaste**)
  *Anschliessend auf unsere Beilklinge mit der **rechten Maustaste** und wir ehalten das Vobfenster mit der Option einen oCTriggerScript als Child of Mover einzusetzen.
{{:quickstart:octrig_14.jpg|}}

* Wir klicken mit der **linken Maustaste** auf "Insert(oCTriggerScript)as child of "Name_Mover"
  * Ein Blick in das Objekt**List**Fenster
{{:quickstart:octrig_15.jpg|}}

* Wir editieren die BoundingBox des Triggers und vollziehen die Schritte 2.2 -> 2.5, oberhalb beschrieben  nach
  * und stellen jetzt die Boundingbox des Schadentriggers von der Grösse her so ein, dass die BoundingBox die Beilklinge umschliesst. 
{{:quickstart:octrig_16.jpg|}}

*Wir benennen den oCTriggerScript mit vobName:TS_BEILSCHADEN_D und wenn wir jetzt den Mover bewegen, bewegt sich der an die Beilklinge gehängte Schadenstrigger mit.
{{:quickstart:octrig_17.jpg|}} {{:quickstart:octrig_18.jpg|}}

*Das wiederholen wir jetzt mit den 3 anderen Beilklingen.
  *Wir stellen den Schadenstrigger so ein, dass er Berührung reagiert (siehe oben 2.10)
  *Beispiel scriptFunc:DAMAGE_D 
  *Und jetzt benötigen wir noch ein Script um den Schaden zu erzeugen: Beispiel Schaden Hero
<code>
func void damage_d()
{
  if (Npc_IsPlayer(PC_Hero))
  {
    PRINT("AUA!"); //TESTPRINT
    Npc_ChangeAttribute(hero, ATR_HITPOINTS, -50);
  };
};
</code>

Dieses Script ebenfalls noch 3x schreiben, für die anderen Klingen.

Dazu könnt ihr noch den Sound eintragen wenn ihr wollt, dass das Opfer schreit bei einem Treffer (DUMMY_WOUND)
und/oder Blut spritzen lassen..... wie es euch gefällt.

2016/02/22(dlz)

Bitte löse folgende Gleichung um zu zeigen dass du ein Mensch bist. 137 +6 = ? Dieses Feld bitte leer lassen:

Zusammenfassung

Editing Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Seiten-Werkzeuge