ANLEITUNG ZUM LUA SCRIPTEN


Dies ist eine Anleitung wie ihr LUA Scripts einsetzt und verwendet!
( Ich habe sie ins Deutsche übersetzt aus dem Ascentwiki )


Um im Spiel eine Announce auszugeben müsst ihr folgendes in den Script eingeben, benutzt es wenn ihr etwas als eine Announce ausgeben wollt:

Zitat: print "Test Test"
print "Test² Test²"


Falls ihr ein paar Evente starten wollt benutzt folgendes:

UnitID

Zitat: " Die ID eines NPC's der sich in der Datenbank befindet "


Event

Zitat: 1 = Kampf beitreten
2 = Kampf verlassen
3 = Ziel töten
4 = Tot
5 = AI Tick
6 = Spawn
7 = Gossip Talk
8 = Wegpunkt erreicht
9 = Verlassen von Limbo
10 = Spieler betreten das Feld


FunctionName

Zitat: Eine Funktion die gerufen wird sobald das Event startet


Beispiel Code:

Zitat:
RegisterUnitEvent(6, 1, "Jemand_derdenKampfbetritt")
function Jemand_derdenKampfbetritt(pUnit, Event, miscUnit, Misc)
...
end


Einheitliche Befehle:

Zitat: :GetName() : Returns the unit's name.
:Getx() : Returns the unit's X position.
:Gety() : Returns the unit's Y position.
:Getz() : Returns the unit's Z position.
:GetO() : Returns the unit's orientation.
:IsPlayer() : Returns true if the unit is a player, false otherwise.
:IsCreature() : Returns true if the unit is a creature, false otherwise.
:HasFinishedQuest(questID) : Returns true or false depending on if the quest has been completed.
:GetItemCount(itemID) : Returns the number of the items a unit has.
:GetHealthPct() : Returns the unit's health as a percentage.
:GetUnitBySqlId(sqlID) : Returns a unit from the sql ID.
:GetClosestPlayer() : Returns the nearest in-range unit that is a player.
:GetRandomPlayer(flags) : Returns a random in-range unit that is a player.
:GetRandomFriend() : Returns a random in-range unit that is a player and is friendly towards the current player.
:GetMainTank() : Returns the main tank (most hated).
:GetAddTank() : Returns the add tank (second most hated).
:GetTauntedBy() : Returns the player that taunted the unit.
:GetSoulLinkedWith() : Returns the unit that is set as the soul link for this unit.

: RegisterEvent() :
: SendChatMessage(type, language, message) : 'Unit says: <message>' style chat message.
: SendBroadcastMessage(message) :
: SendAreaTriggerMessage(message) :
: MoveTo(x, y, z, o) : Moves the unit to the specified position.
: CastSpell(spellID) : Causes the unit to cast a spell.
: CastSpellOnTarget(spellID, unitTarget) : Casts a spell on a target unit.
: FullCastSpell(spellID) : Casts a spell with casting time.
: FullCastSpellOnTarget(spellID, unitTarget) : Casts a spell with casting time on a target unit.
: SpawnGameObject(entryID, x, y, z, o, duration) : Spawns a gameobject at the specified position, despawning after duration milliseconds.
: SpawnCreature(entryID, x, y, z, o, faction, duration) : Spawns a creature at a position with specified faction, despawning after duration milliseconds.
: KnockBack(dx, dy, affect1, affect2) :
: MarkQuestObjectiveAsComplete(questID, objective) : Marks an objective of a quest as complete.
: LearnSpell(spellID) : Adds a spell to a unit.
: UnlearnSpell(spellID) : Removes a spell from a unit.
: Despawn(delay, respawn) : Despawns a unit after delay milliseconds and respawns it after respawn milliseconds.
: PlaySoundToSet(soundID) : Plays a sound to the surrounding area.
: RemoveAura(auraID) : Removes an aura from a unit.
: StopMovement(time) : Stops a unit from moving for time milliseconds.
: Emote(emoteID) : Tells a unit to perform an emote.
: AddItem(itemID, count) : Adds a quantity of items to a unit.
: RemoveItem(itemID, count) : Removes a quantity of items from a unit.
: CreateCustomWaypointMap() : Creates a custom waypoint map.
: CreateWaypoint(x, y, z, o, waitTime, flags, modelID) : Adds a waypoint to the custom waypoint map.
: DestroyCustomWaypointMap() : Destroys a created custom waypoint map.
: MoveToWaypoint(waypointID) : Tells a unit to move to a particular waypoint.
: SetMovementType(movementType) :
: SetCombatCapable(value) : If value is 1 the unit cannot attack.
: SetHealthPct(value) : Sets the unit's health percentage.
: SetNPCFlags(flags) : Sets the NPC flags of a unit.
: SetModel(modelID) : Sets the model (display ID) of a unit.
: SetScale(scale) : Sets the scale (size) of a unit.
: SetFaction(factionID) : Sets the faction of a unit.
: SetTauntedBy(unit) : Sets the unit that taunted the current unit.
: SetSoulLinkedWith(unit) : Sets the unit that is soul linked with this unit.
: ClearHateList() : Sets the highest hate/threat to one the hate list.


Gameobject Events:

Zitat: Dies wird verwendet um ein Event mit Spielobjekten zu veranstalten


GameObjectID:

Zitat:
Die ID eines Spielobjektes ( GameObjects ) die sich in eurer Datenbank befindet

Event:

Zitat: 1= Spawn
2= Use


FunctionName:

Zitat: Eine Funktion die gerufen wird sobald das Event startet


Beispiel Code:

Zitat:
RegisterGameObjectEvent(6, 1, "SomeObject_OnSpawn")
function SomeObject_OnSpawn(pGameObject, Event)
...
end


GameObject Commands:

Zitat: : GetName() : Returns the gameobject's name.
: SpawnCreature(entryID, x, y, z, o, faction, duration) : Spawns a creature at a position with specified faction, despawning after duration milliseconds.
: PlayCustomAnim() :
: PlaySoundToSet() :

MfG Grimbald


EDIT: Dieser Thread wird immer weiter ausgebaut mit Lua-Beispiel-Scripts, Ergänzungen o.ä!

EDIT2: Manche Sachen werden von mir sein, manche auch nicht! Ich werde es dazu schreiben!


Der Kobold der schreit " You no take Candle " ( aus der offiziellen ascent Seite )

Zitat: function KoboldVermin_OnEnterCombat(pUnit, Event)
if math.random() > 0.5 then -- math.random() will return a float between 0 and 1 (not including 1).
pUnit:SendChatMessage(11, 0, "You no take candle!") -- 11 is monster say, and 0 is universal language
else
pUnit:SendChatMessage(11, 0, "Yiieeeeeee! Me run!") -- 11 is monster say, and 0 is universal language
end
end

RegisterUnitEvent(299, 1, "KoboldVermin_OnEnterCombat") -- On Enter Combat event for unit with ID 6


Falls ihr wollt das ein Mob anfängt zu sprechen sobald ein Spieler in seine Reichweite kommt benutzt diesen LUA Script:

Zitat: function Test1(Unit, Event)
Unit:RegisterEvent("Test2",Event ID ( hier bitte 60000 benutzen ),0)
end

function Test2(Unit, Event)
Unit:SendChatMessage(11, 0, "Der gewünschte Text hierein!")
end


RegisterUnitEvent(50,10,"Test1")


Portale per LUA erstellen.

LUA Script:

Zitat: function Teleporting_onUse (pUnit, Event, pMisc)
pMisc:Teleport (MAPID, X, Y, Z)
end
RegisterGameObjectEvent (PORTALGUID, 2, "Teleporting_onUse")

Die SQL für die Datenbank:

Zitat: INSERT INTO gameobject_names
(entry, Type, DisplayID, Name, spellfocus, sound1, sound2, sound3, sound4, sound5, sound6, sound7, sound8, sound9, unknown1, unknown2, unknown3, unknown4, unknown5, unknown6, unknown7, unknown8, unknown9, unknown10, unknown11, unknown12, unknown13, unknown14)
VALUES
(PORTALGUID, 1, DISPLAYID, "NameDesPortals", 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);


Arthas, bevor er zum Lich König mutierte! ( Ein Projekt aus dem A-Forum )

Zitat: LUA-Script und .SQL Datei liegt im Anhang unter dem Namen " Arthas.zip "


Wie ist ein LUA-Script aufgebaut

Nun, hier möchte ich euch nun zeigen wir ihr Schritt für Schritt euren eigenen LUA-Script erstellt.

Jeder LUA-Script besteht aus 3 verschiedenen Funktionen:

1. Die Funktionen

Zitat: function funktionsname(pUnit, Event)
end

2. Der Inhalt der Funktionen

Zitat: function functionname(pUnit, Event)
Inhalthierrein
Inhalthierrein
end

3. Und das RegisterUnitEvent

function funktionsname(pUnit, Event)
Inhalthierrein
Inhalthierrein
end
RegisterUnitEvent(CreatureId, Event, "funktionsname")

Der Basis-Aufbau vom RegisterUnitEvent:

Das RegisterUnitEvent steht dafür dass das Script startet wenn ein Event geschieht z.B (1 ist im Kampf, 2 ist wenn der Kampf vorüber ist, 3 ist wenn das Ziel tot ist und 4 ist wenn der Mob tot ist etc)

Zitat: RegisterUnitEvent(KreaturID, Event, "FunktionsName"

Ich fange mal mit 4 Events an damit ihr seht wie so etwas aufgebaut ist ( ich habe die Events markiert! ):

Zitat: RegisterUnitEvent(1234, 1, "aaa_imKampf")
RegisterUnitEvent(1234, 2, "aaa_Kampfverlassen")
RegisterUnitEvent(1234, 3, "aaa_ZielIstTot")
RegisterUnitEvent(1234, 4, "aaa_WennStirbt")

Beispiel:

Zitat: function aaa_imKampf(Unit, Event)
end

function aaa_Kampfverlassen(Unit, Event)
Unit:RemoveEvents()
end

function aaa_ZielIstTot(Unit, Event)
end

function aaa_WennStirbt(Unit, Event)
Unit:RemoveEvents()
end

RegisterUnitEvent(1234, 1, "aaa_imKampf")
RegisterUnitEvent(1234, 2, "aaa_Kampfverlassen")
RegisterUnitEvent(1234, 3, "aaa_ZielIstTot")
RegisterUnitEvent(1234, 4, "aaa_WennStirbt")


Als nächstes fügen wir einen Text hinein den der Mob sprechen soll. Dazu verwenden wir folgenden LUA Script:

Zitat: Unit:SendChatMessage(type, lang, "message")

Der Type bestimmt ob der Mob den Text sagen oder ihn schreien soll ( 11 = sagen ; 12 = schreien )

Wenn wir nun unseren obrigen Scripte hinzu ergänzen sieht das dann so aus:

Zitat: function aaa_imKampf(Unit, Event)
Unit:SendChatMessage(11, 0, "Du wirst verlieren!")
end

function aaa_Kampfverlassen(Unit, Event)
Unit:RemoveEvents()
end

function aaa_ZielIstToT(Unit, Event)
Unit:SendChatMessage(11, 0, "Jetzt biste down!")
end

function aaa_WennStirbt(Unit, Event)
Unit:SendChatMessage(11, 0, "Häää??")
Unit:RemoveEvents()
end

RegisterUnitEvent(1234, 1, "aaa_imKampf")
RegisterUnitEvent(1234, 2, "aaa_Kampfverlassen")
RegisterUnitEvent(1234, 3, "aaa_ZielIstTot")
RegisterUnitEvent(1234, 4, "aaa_WennStirbt")

Wie ihr nun seht habt ihr ganz einfach eine Textausgabe eingefügt in euer LUA-Script!

Aufgepasst, nun kommen die Spells dran!
Die Syntax lautet wie folgt:

Zitat: Unit:CastSpell(SpellId)
Unit:FullCastSpell(SpellId)
Unit:CastSpellOnTarget(SpellId, Ziel)
Unit:FullCastSpellOnTarget(SpellId, Ziel)

Wie ihr z.B den CastSpell einfügt seht ihr hier:

Zitat: function aaa_imKampf(Unit, Event)
Unit:SendChatMessage(11, 0, "Du wirst verlieren!")
Unit:CastSpell(1337)
end

function aaa_Kampfverlassen(Unit, Event)
Unit:RemoveEvents()
end

function aaa_ZielIstToT(Unit, Event)
Unit:SendChatMessage(11, 0, "Jetzt biste down!")
end

function aaa_WennStirbt(Unit, Event)
Unit:SendChatMessage(11, 0, "Häää??")
Unit:RemoveEvents()
end

RegisterUnitEvent(1234, 1, "aaa_imKampf")
RegisterUnitEvent(1234, 2, "aaa_Kampfverlassen")
RegisterUnitEvent(1234, 3, "aaa_ZielIstTot")
RegisterUnitEvent(1234, 4, "aaa_WennStirbt")

Falls ihr wollt das der Spell auf einen Spieler / Ziel eurer Wahl gecastet wird müsst ihr die Target-Scripts verwenden. Der Syntax lautet:

Zitat: Unit:GetClosestPlayer()
Unit:GetRandomPlayer(flags)
Unit:GetMainTank()
Unit:GetAddTank

Natürlich gibt es nochmehr davon doch das sind die Targets die am meisten verwendet werden.

Wenn wir nun Unit:GetRandomPlayer einsetzten müsste das wie folgt ausschauen damit der Spiel auf einen beliebigen Spieler gewirkt wird:

Zitat: function aaa_imKampf(Unit, Event)
Unit:SendChatMessage(11, 0, "Du wirst verlieren!")
end

function aaa_Kampfverlassen(Unit, Event)
Unit:RemoveEvents()
end

function aaa_ZielIstToT(Unit, Event)
Unit:SendChatMessage(11, 0, "Jetzt biste down!")
end

function aaa_WennStirbt(Unit, Event)
Unit:SendChatMessage(11, 0, "Häää??")
Unit:RemoveEvents()
end

RegisterUnitEvent(1234, 1, "aaa_imKampf")
RegisterUnitEvent(1234, 2, "aaa_Kampfverlassen")
RegisterUnitEvent(1234, 3, "aaa_ZielIstTot")
RegisterUnitEvent(1234, 4, "aaa_WennStirbt")

Wie ihr nun seht habt ihr ganz einfach eine Textausgabe eingefügt in euer LUA-Script!

Aufgepasst, nun kommen die Spells dran!
Die Syntax lautet wie folgt:

Zitat: Unit:CastSpell(SpellId)
Unit:FullCastSpell(SpellId)
Unit:CastSpellOnTarget(SpellId, Ziel)
Unit:FullCastSpellOnTarget(SpellId, Ziel)

Wie ihr z.B den CastSpell einfügt seht ihr hier:

Zitat: function aaa_imKampf(Unit, Event)
Unit:SendChatMessage(11, 0, "Du wirst verlieren!")
Unit:CastSpell(1337)
Unit:CastSpellOnTarget(24573, Unit:GetRandomPlayer(0)
end

function aaa_Kampfverlassen(Unit, Event)
Unit:RemoveEvents()
end

function aaa_ZielIstToT(Unit, Event)
Unit:SendChatMessage(11, 0, "Jetzt biste down!")
end

function aaa_WennStirbt(Unit, Event)
Unit:SendChatMessage(11, 0, "Häää??")
Unit:RemoveEvents()
end

RegisterUnitEvent(1234, 1, "aaa_imKampf")
RegisterUnitEvent(1234, 2, "aaa_Kampfverlassen")
RegisterUnitEvent(1234, 3, "aaa_ZielIstTot")
RegisterUnitEvent(1234, 4, "aaa_WennStirbt")

Ich hoffe diese kleine Anleitung war euch behilflich, wenn ihr mögt postet doch einfach eure Ergebnisse hier rein was ihr schon mit LUA vollbracht habt. Viel Erfolg und Spaß damit.


Wie aktiviere ich die LUA Scripts und wohin damit?


Zunächst einmal erstellst du einen Ordner mit dem Namen Scripts, so sollte es dann ausschauen: " Festplatte:/Ascent/Scripts ".
Danach öffnest du deine ascent-world.conf und suchst den Eintrag:

Zitat: #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
# Scripting Engine Setup
#
# Ascent can support multiple script backends via the means of loading .dll files for them.
# This section in the config can enable/disable those backends.
#
# LUA
# If you would like to enable the LUA scripting backend, enable this.
# Default: 0
#
#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#

<ScriptBackends LUA="0" <- Das in "1" umändern
AS="0">


Dann hast du erfolgreich die LUA Scripts aktiviert und kannst deinen Server neu starten.

Ich hab seine erlaubnis
die anderen hab ich selber gemacht

ok das hat sich erledigt hab noch ne frage ich hab ein portal gemacht das funzt nach hyjal alles perfekr aba als ich ein zweites machte nach sw brachte es mich nach hyjal warum das denn