Hilfe:Skript-API - Versionsgeschichte

Maintenance script: Eigene-Fenster

2026-10-14T22:06:30Z

Eigene-Fenster

@@ Zeile 141: / Zeile 141: @@
 API.SavePersistentVar("Runden", anzahl)
 print(f"Skript lief schon {anzahl} Mal")
 </syntaxhighlight>

Maintenance script: Skript-Bibliothek

2026-10-14T21:37:39Z

Skript-Bibliothek

← Nächstältere Version		Version vom 14. Oktober 2026, 21:37 Uhr
Zeile 1:		Zeile 1:
	~~Alle~~ Befehle, die ein Skript im Schattenwelt-Client benutzen kann. Skripte sind Python 3 (über ''pocketpy''); die Namen folgen der Legion-API von TazUO, viele TazUO-Skripte laufen deshalb mit wenig Anpassung. Benutzung, Regeln und Teilen: [[Hilfe:Skripte]].		Alle Befehle, die ein Skript im Schattenwelt-Client benutzen kann. Skripte sind Python 3 (über ''pocketpy''); die Namen folgen der Legion-API von TazUO, viele TazUO-Skripte laufen deshalb mit wenig Anpassung. Benutzung, Regeln und Teilen: [[Hilfe:Skripte]].

	== Grundlagen ==		== Grundlagen ==

Maintenance script: Skript-Bibliothek

2026-10-14T21:36:24Z

Skript-Bibliothek

Neue Seite

Alle Befehle, die ein Skript im Schattenwelt-Client benutzen kann. Skripte sind Python 3 (über ''pocketpy''); die Namen folgen der Legion-API von TazUO, viele TazUO-Skripte laufen deshalb mit wenig Anpassung. Benutzung, Regeln und Teilen: [[Hilfe:Skripte]].

== Grundlagen ==
* Alle Befehle liegen im Modul <code>API</code>, das ohne <code>import</code> verfügbar ist.
* Serials, Grafiken und Farben sind Zahlen, z. B. <code>0x0EED</code>.
* <code>print(...)</code> schreibt mit dem Skriptnamen ins Journal, Fehler erscheinen rot.
* Eigene Hilfsmodule im Ordner <code>Scripts</code> lassen sich mit <code>import</code> laden.
* <code>.script <name></code> startet oder stoppt ein Skript, <code>.script stop</code> stoppt alle. Bis zu 15 Skripte laufen gleichzeitig.
* Höchstens eine Aktion pro Sekunde über alle Skripte. Aktionen sind Benutzen, Bewegen, Ausrüsten, Zaubern, Skills, Angriff, Ziele, Sprechen und Gump-Antworten.

== Nachrichten und Ablauf ==
{| class="wikitable"
! Befehl !! Beschreibung
|-
| <code>SysMsg(msg, hue=946)</code> || Systemnachricht, nur für dich
|-
| <code>Msg(msg)</code> || sprechen
|-
| <code>EmoteMsg(msg)</code> || Emote
|-
| <code>HeadMsg(msg, serial, hue=946)</code> || Text über einem Objekt, nur für dich
|-
| <code>Pause(sekunden)</code> || warten (bis 600 s)
|-
| <code>Stop()</code> || Skript beenden
|}

== Spieler ==
<code>API.Player</code> liefert immer aktuelle Werte: <code>Serial</code>, <code>Name</code>, <code>Hits</code>, <code>HitsMax</code>, <code>Mana</code>, <code>ManaMax</code>, <code>Stam</code>, <code>StamMax</code>, <code>Str</code>, <code>Dex</code>, <code>Int</code>, <code>Weight</code>, <code>WeightMax</code>, <code>Gold</code>, <code>X</code>, <code>Y</code>, <code>Z</code>, <code>IsDead</code>, <code>IsPoisoned</code>, <code>InWarMode</code>, <code>IsHidden</code>.

<code>API.Backpack</code> ist die Serial deines Rucksacks.

== Suchen ==
{| class="wikitable"
! Befehl !! Ergebnis
|-
| <code>FindItem(serial)</code> || Item oder <code>None</code>
|-
| <code>FindType(grafik, container=None, range=None, hue=None, minamount=0)</code> || erstes passendes Item oder <code>None</code>
|-
| <code>FindTypeAll(grafik, container=None, range=None, hue=None, minamount=0)</code> || Liste von Items
|-
| <code>FindLayer(layer, serial=None)</code> || getragenes Item auf einem Layer
|-
| <code>ItemsInContainer(container, recursive=False)</code> || Liste von Items
|-
| <code>Contents(container)</code> || Anzahl Items im Behälter
|-
| <code>GetItemsOnGround(distance=2, graphic=None)</code> || Items am Boden in der Nähe
|-
| <code>FindMobile(serial)</code> || Mobile oder <code>None</code>
|-
| <code>GetAllMobiles(distance=18)</code> || Liste von Mobiles
|-
| <code>NearestMobile(distance=10)</code> || nächstes lebendes Mobile oder <code>None</code>
|-
| <code>GetSkill(name_oder_nummer)</code> || Skillwert als Zahl
|}

Ein '''Item''' hat <code>Serial</code>, <code>Graphic</code>, <code>Hue</code>, <code>Amount</code>, <code>Name</code>, <code>Container</code>, <code>Layer</code>, <code>X</code>, <code>Y</code>, <code>Z</code>, <code>Distance</code>, <code>OnGround</code>, <code>IsCorpse</code>. Ein '''Mobile''' hat <code>Serial</code>, <code>Graphic</code>, <code>Hue</code>, <code>Name</code>, <code>X</code>, <code>Y</code>, <code>Z</code>, <code>Distance</code>, <code>Hits</code>, <code>HitsMax</code>, <code>Notoriety</code>, <code>IsDead</code>, <code>IsHuman</code>, <code>IsPet</code>, <code>IsYou</code>. Diese Werte sind ein Schnappschuss zum Zeitpunkt des Aufrufs.

== Handeln ==
{| class="wikitable"
! Befehl !! Beschreibung
|-
| <code>UseObject(serial)</code> || Doppelklick
|-
| <code>UseType(grafik, hue=None, container=None)</code> || erstes passendes Item benutzen, <code>True</code>/<code>False</code>
|-
| <code>ClickObject(serial)</code> || Einfachklick
|-
| <code>MoveItem(serial, ziel, amount=0)</code> || Item in einen Behälter legen (0 = ganzer Stapel)
|-
| <code>EquipItem(serial)</code> || anziehen
|-
| <code>CastSpell(name_oder_nummer)</code> || zaubern
|-
| <code>UseSkill(name_oder_nummer)</code> || Fertigkeit benutzen
|-
| <code>Attack(serial)</code> || angreifen (keine Spieler)
|-
| <code>SetWarMode(True/False)</code> || Kampfmodus
|}

== Ziele ==
{| class="wikitable"
! Befehl !! Beschreibung
|-
| <code>HasTarget(type='any')</code> || gibt es gerade einen Zielcursor? (<code>any</code>, <code>harmful</code>, <code>beneficial</code>, <code>neutral</code>)
|-
| <code>WaitForTarget(type='any', timeout=5)</code> || auf Zielcursor warten, <code>True</code>/<code>False</code>
|-
| <code>Target(serial)</code> || Objekt anvisieren
|-
| <code>TargetSelf()</code> || sich selbst anvisieren
|-
| <code>TargetLocation(x, y, z, graphic=None)</code> || Boden oder Static anvisieren
|-
| <code>CancelTarget()</code> || Zielcursor abbrechen
|}

== Journal ==
{| class="wikitable"
! Befehl !! Beschreibung
|-
| <code>InJournal(text, clear=False)</code> || kam der Text seit Skriptstart im Journal vor? Mit <code>$</code> am Anfang ist es ein regulärer Ausdruck
|-
| <code>InJournalAny(liste, clear=False)</code> || einer der Texte
|-
| <code>ClearJournal()</code> || gemerkte Zeilen leeren
|}

== Gumps (Server-Fenster) ==
{| class="wikitable"
! Befehl !! Beschreibung
|-
| <code>HasGump(gumpid=None)</code> || ist ein Server-Gump offen?
|-
| <code>WaitForGump(gumpid=None, timeout=5)</code> || warten, <code>True</code>/<code>False</code>
|-
| <code>ReplyGump(button, gumpid=None)</code> || Knopf drücken
|-
| <code>CloseGump(gumpid=None)</code> || schließen
|}

== Gespeicherte Variablen ==
Werte, die ein Skript über einen Neustart hinaus behalten soll. Sie sind immer Text (Zahlen werden umgewandelt).
{| class="wikitable"
! Befehl !! Beschreibung
|-
| <code>SavePersistentVar(name, wert, scope=API.PersistentVar.Char)</code> || speichern
|-
| <code>GetPersistentVar(name, default=<nowiki>''</nowiki>, scope=API.PersistentVar.Char)</code> || lesen, <code>default</code> wenn nicht vorhanden
|-
| <code>RemovePersistentVar(name, scope=API.PersistentVar.Char)</code> || löschen, <code>True</code>/<code>False</code>
|}
Bereiche: <code>API.PersistentVar.Char</code> (dieser Charakter), <code>Account</code> (alle Charaktere des Kontos), <code>Server</code> (alle Konten auf diesem Server), <code>Global</code> (alles auf diesem Rechner).

<syntaxhighlight lang="python">
anzahl = int(API.GetPersistentVar("Runden", "0")) + 1
API.SavePersistentVar("Runden", anzahl)
print(f"Skript lief schon {anzahl} Mal")
</syntaxhighlight>

== Beispiel ==
<syntaxhighlight lang="python">
while True:
if API.Player.Hits < API.Player.HitsMax * 0.6:
if API.UseType(0x0E21): # Bandage
if API.WaitForTarget():
API.TargetSelf()
API.Pause(8)
API.Pause(1)
</syntaxhighlight>

[[Kategorie:Tools]]