OSSL/de

From OpenSimulator

Revision as of 23:51, 30 August 2024 by Manni (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


Einführung in die OpenSimulator-Skriptsprache (OSSL)

Die OpenSimulator-Skriptsprache (OSSL) erweitert die Linden Scripting Language (LSL) um zusätzliche Funktionen, die speziell für die OpenSimulator-Plattform entwickelt wurden.

Diese Erweiterungen beginnen mit dem Präfix „os“ und bieten zusätzliche Möglichkeiten, die in LSL nicht verfügbar sind, wie z.B. das Teleportieren von Agenten oder das Anzeigen dynamischer Texturen.

Implementierung einer OSSL-Funktion

Um eine neue OSSL-Funktion hinzuzufügen, sind folgende Schritte notwendig:

1. Implementierung der Funktion

Erstellen Sie eine neue Methode in der Datei `OSSL_Api.cs` im Verzeichnis `OpenSim.Region.ScriptEngine.Shared.Api`. Die Methode sollte die gewünschte Funktionalität enthalten, z.B.:

csharp

public string osMyFunction()
{
    CheckThreatLevel(ThreatLevel.None, "osMyFunction");
    m_host.AddScriptLPS(1);
    return "Hallo Welt!";
}

2. Schnittstelle erweitern

Fügen Sie die Methodensignatur der Schnittstelle `IOOSL_Api` im Verzeichnis `OpenSim.Region.ScriptEngine.Shared` hinzu:

csharp

string osMyFunction();

3. Funktion zur Basis-Klasse hinzufügen

In der Datei `OSSL_Stub.cs` im Verzeichnis `OpenSim.Region.ScriptEngine.Shared.Api.Runtime` fügen Sie die Methode hinzu, um die Funktion über das Interface aufzurufen:

csharp

public string osMyFunction()
{
    return m_OSSL_Functions.osMyFunction();
}

4. OpenSimulator neu kompilieren

Kompilieren Sie OpenSimulator neu und starten Sie den Region-Server.

5. OSSL-Funktionen aktivieren

Stellen Sie sicher, dass in Ihrer `OpenSim.ini` die Einstellung `AllowOSFunctions = true` aktiviert ist, damit die os-Funktionen ausgeführt werden.

Verwendung der neuen OSSL-Funktion

Nach dem Neustart des Servers können Sie die neue Funktion in einem Skript verwenden:

lsl

default
{
    state_entry()
    {
        llSay(0, osMyFunction());
    }
}

Sicherheitsstufen (Threat Level)

Jede OSSL-Funktion wird einer Bedrohungsstufe zugewiesen, die bestimmt, wie sicher ihre Ausführung ist.

Diese Stufen reichen von `None` (keine Bedrohung) bis `High` (hohe Bedrohung).

Der Regionsadministrator kann die Bedrohungsstufen in der `OpenSim.ini` anpassen und einzelne Funktionen aktivieren oder deaktivieren.

Beiträge willkommen

OSSL ist keineswegs vollständig. Daher sind Patches zur Implementierung von Funktionen, die Sie in LSL haben möchten, willkommen - wir freuen uns immer, sie zu prüfen :-)

Personal tools
General
About This Wiki