Projekt Shoebill 1.2 - Schreibe Gamemodes in Java

Wir sind froh euch mitteilen zu können, dass Shoebill ab sofort das neue 0.3.7 Update unterschtützt. Wenn du updaten möchtest, benutze bitte den beigelegten Updater im Hautverzeichnis deines Servers. Einfach die update-shoebill.bat/sh Datei verwenden, und Shoebill wird die nötigen Dateien automatisch runterladen, und ersetzen. Geht sicher, dass ihr beim starten des Server die neuen Dependencies runterladet (sollte eigentlich automatisch passieren).
Für eine Liste von neuen Features könnt ihr hier schauen -> http://wiki.sa-mp.com/wiki/Category:Added_in_0.3.7. Ihr könnt euch auch die GitHub Commits anschauen:

shoebill-runtime: https://github.com/Shoebill/sh…518faa723fe587ba81004ae0e
shoebill-api: https://github.com/Shoebill/sh…643d0291c597785066a162a9f
shoebill-launcher: https://github.com/Shoebill/sh…e80c0272813ef2cda47d1095a
ShoebillPlugin: https://github.com/Shoebill/Sh…4ae6bd521225aabb422a6d9f4

Wenn du nicht die beigelegten Updater verwenden möchtest, kannst du dir auch jede Datei manuell herunterladen:

shoebill-runtime (0.3.7): http://ci.gtaun.net/job/shoebi…-runtime-1.1-SNAPSHOT.jar
shoebill-launcher (0.3.7): http://ci.gtaun.net/job/shoebi…launcher-1.1-SNAPSHOT.jar
shoebill-api (0.3.7): http://ci.gtaun.net/job/shoebi…bill-api-1.1-SNAPSHOT.jar
ShoebillPlugin (0.3.7):
- Windows: http://catboy5.bplaced.net/updater/binaries/Shoebill.dll
- Linux: http://catboy5.bplaced.net/updater/binaries/Shoebill

Wenn du die Entwicklung mit den neuen 0.3.7 Features starten möchtest, musst du einfach dein Maven Projekt neu importieren oder die Dependencies manuell ersetzen.

(Bugs können auftauchen)

//Edit: Ich habe grad ein kleines Update für den addsiren Parameter in der CreateVehicle & AddStaticVehicleEx Funktion gepusht. Der Parameter kann jetzt via Vehicle.create(...); verwendet werden. Außerdem kann mit vehicle.hasSiren() überprüft werden, ob das Fahrzeug eine Sirene hat.

@MiX(eP):

Du brauchst:
- JRE 8 (wenn du es nur laufen lassen willst), oder JDK 8 (wenn du auch Gamemodes entwicklen willst) beide MÜSSEN 32-Bit sein
- (Maven, nicht zwingend, aber würde ich empfehlen)
- eine IDE (am besten IntelliJ IDEA CE, oder Eclipse)
- einen 0.3.7 SAMP Server mit dem Startpaket aus dem 1. Post (am besten einfach das Full-Package runterladen, da ist der Server dabei)

Ich denke mit den Videos ist das alles eigentlich gut erklärt, dort steht alles, von Anfang bis Ende (JDK Installation, Server einrichten etc.).
Hier sind alle Videos:

https://www.youtube.com/watch?v=FLlFeNXPPN8 - Server aufsetzen (war noch mit 0.3z, ist aber genauso mit 0.3.7)
https://www.youtube.com/watch?v=g2SOqax3Euw - Gamemode mit IntelliJ IDEA erstellen (von Anfang bis Ende, mit Maven Installation etc.)

Schön zu hören, wenn du Probleme oder Fragen hast kannst du dich hier melden.

//Edit: Ich habe grade ein Video zum Setup für Eclipse aufgenommen.

Alf21: Danke für dein positives Feedback.

- Shoebill-Funktionen von Pawn aus aufrufen

Um dieses Update zu nutzen, muss der beigelegte shoebill-updater verwendet werden. Einfach die update-shoebill.bat/.sh Datei starten, und Shoebill wird alle Dateien runterladen.

Es freut mich euch mitteilen zu können, dass Shoebill ab sofort die Möglichkeit bietet, von Pawn aus Shoebill Funktionen aufrufen zu können. Aktuell werden Integers, Strings und Floats als Datentypen akzeptiert. Es können
auch Variablen per Referenz übergeben werden, die dann im Java Teil geändert werden können. Hier ein kleines Beispiel:

Als erstes muss eine neue native Funktion in dem Pawn-Skript deklariert werden:
native CallShoebillFunction(name[], {Float,_}:...); (am besten direkt in eine Include-Datei oder einfach oben im Skript)

Nun muss eine Funktion registriert werden, dies geschieht von Java aus. Jede AMX-Datei hat seinen eigenen Funktions-Pool, wenn man will das die Funktion überall verfügbar ist, ist es zu empfehlen die Funktion in dem AmxLoadEvent zu registrieren.
In diesem Beispiel möchte ich das meine Funktion von überall aus verfügbar ist, deswegen werde ich sie im AmxLoadEvent deklarieren:

eventManager.registerHandler(AmxLoadEvent.class, e -> {
     e.getAmxInstance().registerFunction("GetPlayerFactionName", objects -> {
         Player player = Player.get((Integer) objects[0]);
         //Do something to get player's faction etc.
         objects[1] = "Los Santos PoPo";
         //Return value for pawn (not always needed)
         return 1;
     }, Integer.class, String.class);
 });

Die .registerFunction-Methode ist verfügbar in AmxInstance-Objekten.
Erst wird der Name angegeben, gefolgt von der Java-Funktion die aufgerufen wird. Anschließend dann die Parameter-Typen, in dem Falle Integer (für die PlayerId) und den String (als Referenz, dort wird der Name reingeschrieben).
Funktionen die registriert werden, sollten auch wieder gelöscht werden. Dies geschieht mit der .unregisterFunction-Methode:

eventManager.registerHandler(AmxUnloadEvent.class, e -> {
    e.getAmxInstance().unregisterFunction("GetPlayerFactionName");
});

von Pawn aus kann die Funktion nun problemlos aufgerufen werden, zum Beispiel unter OnPlayerSpawn:

public OnPlayerConnect(playerid)
{
new factionName[] = "Unknown";
CallShoebillFunction("GetPlayerFactionName", playerid, factionName);
printf("Factionname: %s", factionName);
return 1;
}

Ergebnis: "Factionname: Los Santos PoPo"

Zitat von BlackAce

heißt das, man kann keine Arrays übergeben ?

Oder kann man sich das so PAWN mäßig hintricksen ?

Aktuell nicht, aber das Feature wird bestimmt später mal folgen wenn ich mir weitere Gedanken gemacht habe wie man das am besten umsetzen könnte.

Alles klar, werd ich mir später mal anschauen. Ich bin grad schon mit den Arrays dran, vielleicht schaff ich das heute noch

@BlackAce: Ich hab grad ein Update gepusht, jetzt kann man auch Int und Float Arrays übergeben. String Array kommen vielleicht später mal (Update über shoebill-updater)

//Edit:

Wir sind froh euch mitteilen zu können, dass Shoebill ab sofort das neue 0.3.7 R2 Server Update unterstützt. Um das neue Update verwenden zu können, muss der beigelegte Shoebill-Updater verwendet werden.
Einfach die update-shoebill.bat/.sh Datei starten (alternativ -> java -jar shoebill-updater.jar) und alle alten Daten werden aktualisiert. Außerdem müssen die ausführbaren Dateien vom SA-MP Server auf die neue Version geupdated werden. Einfach das 0.3.7 R2 Paket für euer Betriebssystem wählen, und samp-server.exe, announce.exe und samp-npc.exe ersetzen. Beim nächsten Serverstart werden ebenfalls die benötigten Artefakte runtergeladen.
Welche Änderungen es in der 0.3.7 R2 Version gibt, könnt ihr hier nachlesen: http://forum.sa-mp.com/showthread.php?t=581259

Commits:
API: https://github.com/Shoebill/sh…5808b6592d0a2777c36bc9dd9
Runtime: https://github.com/Shoebill/sh…dd3d529c49319a5acbfcad5b7
Launcher: https://github.com/Shoebill/sh…47602e8e2c1f2e2635413b7e2
Plugin: https://github.com/Shoebill/Sh…4993f98ac6110fa6032410f61

Manueller Download:
API: http://ci.gtaun.net/job/shoebi…bill-api-1.1-SNAPSHOT.jar
Runtime: http://ci.gtaun.net/job/shoebi…-runtime-1.1-SNAPSHOT.jar
Launcher: http://ci.gtaun.net/job/shoebi…launcher-1.1-SNAPSHOT.jar
Plugin:
- Windows: http://catboy5.bplaced.net/updater/binaries/Shoebill.dll
- Linux: http://catboy5.bplaced.net/updater/binaries/Shoebill

Verwendung:

Server server = Server.get();
server.setStringVar("varname", "value");
server.setIntVar("intvarname", 15);
server.setFloatVar("floatvarname", 13.56f);


String value = server.getStringVar("varname"); //"value"
int intval = server.getIntVar("intvarname"); //15
float floatval = server.getFloatVar("floatvarname"); //13.56


server.deleteVar("varname"); //delete string
server.hashPassword("my-secreet-password", "my-salt"); //hash passwords with SHA256_PassHash() Method

//Edit: 16.08.15:


Wir bieten nun auch einen offiziellen Wrapper für OS X an, damit lässt sich Shoebill und der SAMP Server ganz einfach und bequem unter einem Mac ausführen.
Der Wrapper enthält bereits das JDK 1.8 und alle anderen benötigten Runtimes. Zusätzlich wurde noch ein Video aufgenommen, um den Einstieg so leicht wie möglich zu machen:

Download für den Wrapper (einfach per Doppelklick starten und der Server läuft): https://mega.nz/#!2hgA2BTK!Xwm…uUqCKyVg_ct_A1dYjpOALOULw

Besucht auch unsere neue Github.IO Seite, um immer auf dem neusten Stand zu bleiben: klick


//Edit: 26.08.15:


Wir haben grade unsere Vorstellung überarbeitet mit neuen Grafiken und neuen Texten: klick
Wir würden uns über Feedback sehr freuen.

Danke Mert_Coleman.

Die erste Snapshot-Version von Shoebill 1.2 ist nun zum Download verfügbar. Haltet euch vor Augen, dass diese Version noch nicht Stabil läuft. Der Server könnte sich unerwartet verhalten. Die größte Änderung in dieser Version ist, dass Shoebill seine internen Komponenten geändert hat. Es benutzt nun Sampgdk anstatt einem eigenem Hooking-System. Diese Änderung wird bessere Kompatibilität mit anderen Plugins und Gamemodes bieten.

Fertig:

• Internes Hooking-System mit Sampgdk ersetzen
• Support für die neuen Dialoge aus SAMP 0.3.7

Geplant:

• Kaputte Funktionen reparieren, welche durch die Änderung aufgetreten sind
• ?

Die Shoebill-Api hat sich ein wenig geändert, in der Weise wie sie das Amx Interface behandelt. Es ist nötig seine Version der Shoebill-Api auf 1.2-SNAPSHOT zu ändern. In der resources.yml Datei ist es nötig die Version der Runtime auf 1.2-SNAPSHOT zu ändern. Außerdem ist es nötig den Launcher und das Plugin zu updaten, am besten mithilfe des Shoebill Updater (einfach die update-shoebill.bat/.sh Datei starten) oder manuell die Dateien runter zu laden:

• Plugin (Windows): http://catboy5.bplaced.net/updater/binaries/Shoebill.dll
• Plugin (Linux): http://catboy5.bplaced.net/updater/binaries/Shoebill
• Launcher: http://catboy5.bplaced.net/upd…launcher-1.2-SNAPSHOT.jar

(Das Plugin in den "plugins" Ordner verschieben und den Launcher nach shoebill/bootstrap verschieben)
Stellt sicher, dass ihr den offlineModus einmal deaktiviert (in der resources.yml) damit Shoebill die neusten Artefakte aus unserer Quelle runter laden kann (http://repo.gtaun.net)

(Updates können in kurzen oder langen Zeitperioden auftauchen, bitte darauf achten, dass Ihr auf dem aktuellstem Stand seid bevor ihr einen Bug meldet.)

//Update 29. November:

Die neuen Dialogtypen von SAMP 0.3.7 können nun via shoebill-common-1.2-SNAPSHOT verwendet werden.

Folgendes muss in der pom.xml geändert / hinzugefügt werden

<dependency>
    <groupId>net.gtaun</groupId>
    <artifactId>shoebill-common</artifactId>
    <version>1.2-SNAPSHOT</version>
    <type>jar</type>
    <scope>compile</scope>
</dependency>

Danach kann ein TabListDialog mit oder ohne Header erstellt werden:

TabListDialog.create(player, eventManager)
    .caption("My Dialog")
    .buttonOk("Buy")
    .buttonCancel("Cancel")
    .header(0, "Weapon")
    .header(1, "Price ($)")
    .item(TabListDialogItem.create()
        .column(0, ListDialogItem.create().itemText("Deagle").build())
        .column(1, ListDialogItem.create().itemText("$500").build())
        .onSelect((item, o) -> {
            //Give player a Deagle
        })
        .build())
    .item(TabListDialogItem.create()
        .column(0, ListDialogItem.create().itemText("M4").build())
        .column(1, ListDialogItem.create().itemText("$12000").build())
        .onSelect((item1, o1) -> {
            //Give player a m4
        })
        .build())
    .build()
    .show();

Es können 0-3 Header via der .header() Funktion gesetzt werden, und Reihen mit der .item() Funktion hinzugefügt werden.
Es müssen TabListDialogItems anstatt normale ListDialogItems verwendet werden. Mit der .column() Funktion kann der Inhalt der Spalten 0-3 gesetzt werden. Als Inhalt werden normale ListDialogItems verwendet und somit können auch RadioItems und Switches verwendet werden. Handler können mit der .onSelect() Methode gesetzt werden.

Hier ein Screenshot:

Shoebill erstellt beim Start eine vollwertige Java Maschine, du kannst also alle Features von Java 8 verwenden. Auch weitere Threads können eröffnet werden, um somit rechenintensive Berechnungen durchzuführen. Außerdem bietet Shoebill eine "objekt-orientierte" Erfahrung im Gegensatz zu Pawn, und bietet durch shoebill-common auch viele Hilfsklassen die einem eine Menge Arbeit abnehmen bei alltäglichen Aufgaben.