Yet another Quest Writing Tutorial

[.Alpha.]

Yet another Quest Writing Tutorial
Hello elitepvpers,
Today proudly present you my new Quest Writing tutorial.
In this tutorial I show you how you can write quests, but I show it to you in my way this means,
I show you how to write good quest code, and tell you what you can do and what you can’t.

To follow this tutorial you need no special knowledge, but some basics wouldn’t be bad.

Let me tell you a little story about what we will do in this tutorial.

We start at the total beginning. You will start with doing some simple stuff ending with writing real complex things. In this Lessons I will give you tasks, you don’t have to do them but it’s easier when you do them. At the end of the tutorial you will find the solutions to the tasks. Please don’t try to learn all of this at one single day take you time, this tutorial should not distract you from something like tasks for your server or other private matters. After you completed this tutorial you should be in the enviable position to write complex quests .

I think many of you will ask why I write this tutorial in English, it was my first decision because it’s really important that everyone can understand this tutorial.

The shiny beginning thingymabbabery
So you want to learn Quest writing this means also you want to learn something about LUA.

If you want to learn something about the big history of LUA read .
Afterwards come back to this tutorial!

If you don’t want to learn the big history of LUA here the shorter version:
Visit http://en.wikipedia.org/wiki/Lua_(programming_language), Wikipedia (for the win)
Now after you did or not you have some questions?

Why does Metin2 use LUA for Quests?
I don’t know exactly. But maybe because it’s easy to use, easy to learn and it has many possibilities.

So the .quest Language is LUA?
No, not exactly. It’s basically LUA but it has lot of modifications you will see later.

When it’s not exactly LUA why does anybody talk about LUA?
Because there is a program in the quest folder called ‘qc’, this program is a quest compiler (QC).
The quest compiler loads a quest file and compiles it into pure LUA the pure LUA code is in the object folder. When you look at the object folder you will see many other folders, each folder means one NPC, one timer or some other things I explain later in this tutorial. The only thing you should now is that everything you write in quests gets to the object folder.


Quest editors are bad?!
In the moment there a quest editors but no really good one, I have nothing against them you can use them but you should be able to write quests without quest editors. If you find a good IDE for quests use it. A editor is not very good for writing quest… take you time use macros or something like auto completion scripts if you want to save time or simply write template quest (I will post some on the end of this tutorial.)


Writing the first quest?
No, we do the Basics now.
Prepare your brains and keep in mind this takes time.


Variables
What’s that?
So we work with a computer (server) and we have many different values, we must remember. We need them later. This data is in the memory of the computer. The way the computer transfers the data into the memory. But for LUA we don’t need to know how the computer is doing it.
Named Variables

How we name them is pointless, but there are some rules

• A variable must begin with a letter or a underscore
• A variable is Case sensitive that’s very important
• They may not contain characters other than letters, numbers and underscores.


Variable Scope in Lua
How the word shows there are areas where variables are valid. This has many different reasons and is very useful.
In many languages there are some scopes.

In LUA there are only two Global and Local.

Global variables are avail everywhere.

Local variables only in the code block where there were created.

Something about code blocks, in LUA anything is in code blocks these blocks begin with a command then the block were you work and then the word ‘end’. These blocks can have other code blocks inside them.

Variables without a local before them are avail in any code block, when there is a local before a variable then they are only valid in their own block.

You can’t use end and local as variable name.
Variable types
Variables store values. These values can be different formats there are states, numbers, characters and functions.
• Nil (nothing)(empty)(not existing)
• Numbers
• Characters (Letters, Word, etc.)
• States (true/false)(yes/no)(1/0)
• Functions (special state of a block)
• Tables (explained later)



WTF? Functions are Variables?
Yes, in Lua a variable can store a function so you get a named function. You can do
plantTree = function()
or you do
function plantTree()

functions end with
end

WTF? Tables ? “something to sit on?!? xD”
No, I personally do not sit on tables I sit on chairs.
But let’s get back to the LUA tables.
A table is nothing more than a variable with more than one level, or if you know the word array it describes it good. I personally think tables are much cooler than arrays.

PHP Code:

myTable = {} 


Oh no! My table is empty let’s put something on it.

PHP Code:

myTable = { “soup”, “egg”, “spoon”, 6} 


My Table now is very nice, but I want to use the things I have on my table.
So I do it like this.

PHP Code:

myTable[1] -> contains my nice hot Chinese soup when I print it or do some other stuff with it I’ll get -> soup 


when I now say myTable{4] I get 6 back (muahahaha 6pack )


I don’t want to say myTable[1] to get my item named soup let’s do it again.

PHP Code:

myNewShinyTable = {soup=”Chinese soup”, egg=”egg for the soup”, spoon=”spoon to eat the soup”} 


now I can do it like this

PHP Code:

myNewShinyTable.soup -> Chinese soup
myNewShinyTable.egg -> egg for the soup
myNewShinyTable.spoon -> spoon to eat the soup 


This was it for now come back later!



Comments and Keywords
Welcome Back!
We are getting deeper into Lua, I hope you understood my freaky tutorial. : /
Now you learn the keywords you can’t use for variable names and how to make comments
Comments are essential for understanding your own code after some time and they are also essentials when you share your code.
A comment is made with two ‘-‘ -> ‘—‘

PHP Code:

--This is a single line comment
 ––[[ this is a multi
    Line comment! ]] 


And these are the keywords you can’t use for variable names and so on if you want to do make it like this -> _and or _else

PHP Code:

   and     break   do    else       elseif
    
    end     false   for   function   if
    
    in      local   nil   not        or
    
    repeat  return  then  true       until     while 


The Syntax of each quest
Like said above anything in Lua is in code blocks and Ymir has done it also in this way.
Any block ends with ‘end’, the Ymir blocks are
• Quest
• State
• When

The blocks are arranged in this order.
This means you have to start a quest like this

PHP Code:

quest name begin 


and end it with

PHP Code:

end 


That means we have

PHP Code:

quest name begin

end 


for the beginning, but let me explain
quest says the quest compiler that a new quest begins (you could put more than one quest in one files)
the word begin is only on the Ymir blocks, at the LUA blocks it’s like listed here

• If -> then
• For -> do
• Elseif -> then
• Quest -> begin
• State -> begin
• When -> begin

Let’s go further:

The quest compile parses

PHP Code:

quest questname begin 


quest -> new quest block
questname -> the name of the quest
begin -> start the block

____________________________________________

Quests have multiple States like a state where you have to bring an item to a NPC.
These states are inside of the quest tag

The Server automatically starts the state named start

PHP Code:

quest questname begin
    state start begin
    end
end 


So we are now in the state start

PHP Code:

state start begin 


state -> new state block
start -> state name
begin -> begin the state

You can’t put code into an state without Events
It gets more complicated by now
You have some Events you can use.

• Login (is cast on login)
• Logout (is cast on login)
• Enter (is cast when entering a new state)
• Leave (is cast wen leaving a state)
• Vnum.kill (is cast when killing the monster with the given vnum e.g. 101.kill = wilddog)
• Kill (is cast when the player kills something)
• npcvnum.chat (is cast when the player click on a npc, opens a menu with all chat events)
• npcvnum.click (is cast when the player clicks on a npc, doesn’t work together with chat)
• letter (quest letter related)
• button(quest letter related)
• info (quest letter related)
• timer (is cast when timer reaches zero)
• server_timer (is cast when server_timer reaches zero)
• .target (with marked target more to this later on our journey) you can bind it with events like click

Let us do a simple example:

We want to display a welcome message to the player every time he changes the map or even does login
We use the function syschat it shows the message in the client message color.
And we use a player related function names pc.get_name()
pc means player character
we connect the string Hello with the return of the function pc.get_name() in lua with two normal points

PHP Code:

quest questname begin
    state start begin
        when login begin
            syschat("Hello"..pc.get_name())
        end
    end
end 


Conditionals with when and if
Now we have our first little quest, but what if we want to show the message only to player who are over level 25
We could do an if query or we use it the Ymir style.

If Query:

PHP Code:

quest questname begin
    state start begin
        when login begin
            if pc.get_level() > 25 then
                syschat("Hello "..pc.get_name())
            end
        end
    end
end 


Ymir Style with ‚with‘ (the better way):

PHP Code:

quest questname begin
    state start begin
        when login with pc.get_level() > 25  begin
            syschat("Hello "..pc.get_name(())
        end
    end
end 


The difference is when you use the if query the login event is cast on every login but you do nothing til the player is level 26
The Ymir Style is the better way, its only cast when the player is over level 25

quest functions
The serversoftware has some functions you can use,
these functions are the quest functions
they are all in the file quest_functions

When you add a new function you have to add it in the quest_function file too.

Here is a little list of quest functions:

PHP Code:

item.get_cell()
    Werte: Keine Werte
    Beschreibung: gibt bei take und use das Aktuell benutzte Item aus.
    Rückgabe: false wenn ein fehler aufgetreten ist ansonsten die Zellennumer im Inventar

item.select_cell(slot)
    Werte:  Slot im Inventar
    Beschreibung: wählt ein Item im Inventar aus so das die item befehle auf das ausgewählte Item angewendet werden.
    Rückgabe: Boolean

item.get_socket(socketid)
    Werte: sockel nummer 0 bis 2
    Beschreibung: Erwartet die Socket ID, wenn diese gegeben ist gibt es den Inhalt des Sockets aus also welches item sich im Sockel befindet.
    Rückgabe: false oder item vnum

item.remove(void)
    Werte: keine
    Beschreibung: Entfernt das Aktuell ausgewählte Item.
    Rückgabe: keine

item.get_id(void)
    Werte: keine
    Beschreibung: Gibt die ID des Aktuell ausgewählten Items aus.
    Rückgabe: false oder itemid

item.select(itemid)
    Werte: Id des Items welches man auswählen will (nicht Vnum)
    Beschreibung: Setzt das ausgewählte Item auf die angegebene ID so das die Item befehle für dieses Item gelten.
    Rückgabe: Boolean

item.get_count(void)
    Werte: Keine
    Beschreibung: Gibt die Anzahl wie groß der Stack des aktuell gewählten Items ist also z.B 50 Perlen zurrück
    Rückgabe: false oder count

item.get_level(void)
    Werte: keine
    Rückgabe: refine_level des gewählten Items z.b Schwert+1 = 1

item.get_name(void)
    Werte: keine
    Rückgabe: Name des gewählten Items

item.get_refine_vnum(void)
    Werte: keine
    Rückgabe: refined_vnum des gewählten Items.

item.get_size(void)
    Werte: keine
    Rückgabe: größe des gewählten items <- Datenbank feld size

item.get_sub_type(void)
    Werte: keine
    Rückgabe: subtype des gewählten Items

item.get_type(void)
    Werte: keine
    Rückgabe: type des gewählten Items

item.get_value(value)
    Werte: value
    Rückgabe: Wert eines Value felds des gewählten Items( value felder= value1 bis 5)

item.get_vnum(void)
    Werte: keine
    Rückgabe: Vnum des gewählten Items

item.has_flag(flag)
    Werte: flag
    Beschreibung: prüft ob das ausgewählte item den angegebenen flag
    Rückgabe: Boolean

item.set_socket(socketnum, value)
    Werte: Sockelnummer, Wert der gesetzt werden soll
    Beschreibung: Setzt bei der Aktuell gewählten Waffe in den angegebenen sockel das angegbene item ein (socketnum max = 2)

game.drop_item_with_ownership(item_vnum, anzahl)
    Beschreibung: Droppt ein Item unter dem Spieler mit seinem Namen darüber der Name bleibt 10 Sekunden darüber

__give_char_priv(rate_type, rate)
    Beschreibung: Gibt dem Aktuell ausgewählten Charakter einen Rate Bonus
    Werte: rate_type = 1 bis 4 (YANG, DROP, YANGBOMB, EXP)
        rate = höhe der Rate

__get_empire_priv_string()
    Beschreibung: Die Aktuellen Boni eines Reiches als String ausgeben

__give_empire_prive(empire, rate_type, rate, time) -- einem Reich einen Bonus geben
    Beschreibung: Gibt einem bestimmten Reich oder allen Reichen einen Rate Bonus
    Werte: rate_type= 1-4 (DROP, GOLD_DROP,TEN_GOLD_DROP, EXP)
        empire = 0-3 0 = alle reiche

__getnpcid(npc_name)
    Beschreibung gibt einem die NPC ID aus wenn man den npc namen als wert angibt

is_test_server()
    Beschreibung: Gibt einen booleschen wert zurrück je nach dem ob der server ein Test Server ist oder nicht

kill_all_in_map(mapindex)
    Beschreibung: Tötet alle NPCs und Monster auf der angegebenen Map eventuell auch Spieler
    Werte: mapindex der Ziel Map

bool_to_str()
    Beschreibung: Konvertiert einen Booleschen Wert zu einem String = "true" oder "false"

cmdchat(clientCMD)
    Beschreibung: Sendet einen Befehl in einem Chat Channel den der Client annimt.
            Wird genutzt für Sachen wie das öffnen eines Privaten Ladens oder die Meldungen beim Uppen

command(cmd)
    Beschreibung: Wie /befehl als Spieler genauso von rechten eingeschränkt

enable_over9refine(int, int)
    Beschreibung: /
    Werte: /

regen_in_map(mapindex, path)
    Beschreibung: Lädt die regen Datei die mit path angeben wird und aktiviert sie auf der mit mapindex angegebenen Map

say_in_map(mapindex, text)
    Beschreibung: Wie say nur das es auf dem angegebenen Map Index für alle angezeigt wird

set_quest_state(questname, state)
    Beschreibung: Setzt bei der angegeben Quest den angegeben State als Aktiv bzw führt ihn aus

set_skin(skin_type)
    Beschreibung: Setzt den Stil des sich öffnenden Quest Fensters (Balken oder nicht, sichtbar oder nicht usw)

syschat(text)
    Beschreibung: Gibt den eingegebenen Text in Metin2 Fehler schrift für den Spieler aus

syserr(text)
    Beschreibung: Gibt einen Quest Fehler im Chat aus wenn der Server ein test_server ist

time_to_str()
    Beschreibung: Gibt die Aktulle Zeit als String zurrück

warp_all_to_village(mapindex, time)
    Beschreibung: Teleportiert alle Spieler die sich auf der Map
            mit dem angegebenen Map Index befinden
            in ihre Dörfer zurrück.
            time setzt die Wartezeit wie lange es dauert bis die Spieler geportet werden.

warp_to_village()
    Beschreibung: Teleportiert den Aktuell gewählten Charakter in sein Dorf zurrück

affect.add(applytype, applyvalue, time)
    Beschreibung: Fügt einen Affect mit dem Type 1000 hinzu somit kann er zusätzlich zu allen anderen Affects gelten
            Gültige applytype's sind 1 bis 80 also Boni ID's

affect.remove()
    Beschreibung: Entfernt den angegebenen affecttype
    Anmerkung: Affect 223 kann nicht entfernt werden
            210 = GM Stun
            211 = GM Slow
            203 = Unsichtbarkeit            
            223 = Chatblock
            500 bis 509 = EXP Boni usw
            514 = Haar
            532 = Pferdename
affect.remove_all_collect()
    Beschreibung: Entfernt alle Collect Affects = Bio Quest Affects

affect.remove_bad() 
    Beschreibung: Entfernt alle Negativen Affects wie Brennen, Gift und Sonstiges
affect.remove_good()
    Beschreibung: Entfernt jegliche Positive Affects auch Skill Buffs usw
affect.remove_hair()
    Beschreibung: Entfernt das aktuelle Haar

building.get_land_id() -- Id des Landes ausgben
building.get_land_info() -- Info über das land ausgeben
building.has_land() -- hat land? 0 oder 1
building.set_land_owner() -- setzt den Besitzer des landes
char_log() -- schreibt was in die log tabelle?
clear_server_timer() -- Server timer zurücksezen
clearmapsignal() -- Blinkenden Punkt auf der Map Löschen
cleartimer() -- timer zurück setzen
color(r,g,b) -- farbe rgb glaubich
complete_quest() -- quest abschließen
complete_quest_state() -- complete sate
confirm() -- bestätigen Ja nein?
sys_log() -- etwas in den system log schreiben?
d.check_eliminated() -- Checken ob alle Monster im Dungeon Berreich getötet wurden.
d.clear_regen() -- Den Respawn im Dungeon anhalten.
d.count_monster() -- Monster Anzahl im Dungeon
d.exit() -- Spieler verlässt den Dungeon
d.exit_all() -- Alle verlassen den Dungeon
d.exit_all_to_start_position() -- Alle werden wieder an die Startposition gesetzt.
d.get_kill_mob_count() -- Gibt die anzahl der im Dungeon getöteten Mobs aus
d.get_kill_stone_count() -- Gibt die anzahl der im Dungeon getöteten Metins aus
d.get_map_index() -- Dungeon Map Index
d.getf() -- Dungeon Flag
d.is_unique_dead() -- Ist ein einziger gestorben?
d.is_use_potion() -- Benutzt jemand einen Pott
d.join() -- Einer Gruppe im Dungeon beitreten
d.jump_all() -- Alle zu einer Position warpen. Dungeon
d.jump_all_local() -- Alle Lokal Warpen Dungeon
d.kill_unique() -- Wurde ein einzelner getötet
d.new_jump() -- Neuer Warp
d.new_jump_all() -- Alle Spieler Warpen neu.
d.purge() -- Ebene einmalig von Monstern säubern
d.purge_unique() -- Eine einziges Monster oder einige verschwinden lassen im Dungeon
d.regen_file()  -- Monster Respawn datei laden
d.revived() -- Wiederbelebt
d.select() -- Dungeon Auswahl
d.set_dest() -- Dungeon Ziel setzen
d.set_exit_all_at_eliminate() -- Wenn ein Gegner getötet wurde verlassen alle die Map
d.set_regen_file() -- Respawn datei setzen.
d.set_unique() -- Einzelnen setzen im Dungeon
d.set_warp_at_eliminate() -- Warp wenn Gegner besiegt.
d.setf() -- Dungeon Flag setzen.
d.spawn() -- Monster im Dungeon Spawnen
d.spawn_goto_mob() -- Spawnt den Mob in Dungeon und teleport dich zu ihm
d.spawn_group() -- Spawnt eine Gruppe im Dungeon
d.spawn_mob() -- Monster Spawnen im Dungen
d.spawn_move_group() -- gruppe spawnen und bewegen?
d.spawn_move_unique() -- einen mob spawnen und bewegen?
d.spawn_name_mob() -- Mob mit namen spawnen ???
d.spawn_stone_door() -- Steintür Spawnen
d.spawn_unique() -- Einzeln Spawnen
d.spawn_wooden_door() -- Holztür spawnen
d.unique_get_hp_perc() -- Leben des einzelnen Monsters abrufen oder Spielers kp
d.unique_set_def_grade() -- Verteidigung des monsters setzen oder Spielers kp
d.unique_set_hp() -- Leben des einzelnen Monsters setzen oder Spielers kp
d.unique_set_maxhp() -- Max Leben des einzelnen Monsters setzen oder Spielers kp
delay() -- Verzögerung
find_npc_by_vnum() -- NPC mit vnum suchen
find_pc_by_name() -- spieler bei namen suchen
find_pc_cond()  -- Spieler auswählen der Konditionen erfüllt
game.drop_item() -- Item fallen lassen
game.get_event_flag() -- Event Flag abrufen
game.get_guild_name() -- Gilden Namen abrufen
game.get_safebox_level() -- Lager größe abrugen
game.get_warp_guild_war_list() -- Gildenkriegsliste abrufen
game.open_mall() -- Itemshop Lager öffnen
game.open_safebox() -- Lager öffnen
game.request_make_guild() -- Anfrage auf Gilde erstellen senden
game.set_event_flag() -- Event Flag setzen
game.set_safebox_level() -- Lager größe ändern
get_global_time() -- Globale Zeit ausgeben
get_locale() -- gewählte locale ausgeben
get_server_timer_arg() -- Server Timer value ausgeben
get_time() -- zeit ausgeben
guild.around_ranking_string() -- Gilden Ranking als String ausgeben
guild.get_any_war() -- Jeden Gildenkrieg abrufen
guild.get_ladder_point() -- Leader Punkte abrufen
guild.get_name() -- Gildenname ausgeben
guild.get_rank() -- Gilden Rank ausgeben
guild.get_reserve_war_table() -- Gildenkriegs liste
guild.get_warp_war_list() -- Gildenkrieg Warpliste
guild.high_ranking_string() -- Highscore als Steing (Gilde)
guild.is_bet() -- Wurde auf die Gilde geboten
guild.is_war() -- nimmt die gilde an einem gildenkrieg teil?
guild.level() -- Gildenlevel ausgeben
guild.name() -- Gildennamen ausgeben
guild.war_bet() -- Auf Gildenkrieg setzen
guild.war_enter() -- Gildenkrieg beitreten
horse.advance() -- Pferd 1 Level up
horse.feed() -- Pferd füttern.
horse.get_grade() -- Pferde Rang ausgeben
horse.get_health() -- Pferde Leben ausgeben
horse.get_health_pct() -- Pferde Leben in Prozent
horse.get_hp() -- Pferde leben ausgeben
horse.get_level() PFerde Level ausgeben
horse.get_stamina() -- Pferde ausdauer ausgeben
horse.get_stamina_pct() -- Pferde ausdauer in Prozenzt
horse.is_dead() -- Ist das Pferd tot?
horse.is_mine -- Ist das mein Pferd
horse.is_riding() -- Sitze ich auf einem Reittier
horse.revive() -- Reittier wiederbeleben
horse.ride() -- Pferd reiten
horse.set_level() -- Pferde level steigen
horse.summon() -- pferd rufen
horse.unride() -- vom pferd absteigen
horse.unsummon() -- Pferd wegschicken
input() -- input feld erstellen wo man was eingeben kann
is_test_server() -- Gibt aus ob es auf Testserver gestellt ist.
loop_timer() -- Loop Timer
npc.is_quest() -- Prüft ob der NPC gerade für eine Quest benötigt wird
pc.change_gold() -- Gold ändern
pc.change_money() -- Gold ändern
pc.change_sp() -- SP ändern
pc.changealignment() -- Rang ändern
pc.changegold() -- Gold ändern
pc.changemoney() -- gold ändern
pc.clear_skill() -- Skill säubern
pc.clear_sub_skill() -- Unterskill leermachen
pc.clear_one_skill() -- einen skill säubern
pc.count_item() -- item zählen
pc.countitem()-- item zählen
pc.delqf() -- was in der quest tabelle löschen
pc.destroy_guild() -- Gilde auflösen
pc.enough_inventory() -- Prüft ob im Inventar platz ist
pc.forget_my_attacker() -- Wie Weiße Flagge monster in der nähe beachten dich kurze zeit nicht
pc.get_armor() -- Rüstung ausgeben
pc.get_empire() -- reich ausgeben
pc.get_equip_refine_level()
pc.get_exp()
pc.get_gold()
pc.get_guild()
pc.get_horse_level()
pc.get_hp()
pc.get_job()
pc.get_leadership() -- Leaderschafft ausgeben
pc.get_level()
pc.get_local_x()
pc.get_local_y()
pc.get_map_index()
pc.get_max_hp()
pc.get_max_sp()
pc.get_money()
pc.get_name()
pc.get_next_exp()
pc.get_part()
pc.get_playtime()
pc.get_sex()
pc.get_skill_level()
pc.get_sp()
pc.get_start_location()
pc.get_vid()
pc.get_war_map()
pc.get_weapon()
pc.get_x()
pc.get_y()
pc.getarmor()
pc.getcurrentmapindex()
pc.getempire()
pc.getf()
pc.getgold()
pc.getguild()
pc.gethp()
pc.getleadership()
pc.getmaxhp()
pc.getmaxsp()
pc.getmoney()
pc.getname()
pc.getplaytime()
pc.getqf(name)
pc.get_skill_group()
pc.getsp()
pc.getweapon()
pc.getx()
pc.gety()
pc.give_exp(exp)
pc.give_exp2(exp)
pc.give_exp_perc(percent)
pc.give_gold(gold)
pc.give_item(vnum)-- gibt Rang punkte zurück
pc.give_item2(vnum)
pc.give_item_from_special_item_group(is_item?)
pc.give_lotto()
pc.has_guild() -- Gibt zurück ob man in einer Gilde ist(1) oder eben nicht(0)
pc.has_master_skill() -- Gibt zurück ob man irgendwas auf hat(1) oder eben nicht(0)
pc.hasguild() -- Gibt zurück ob man in einer Gilde ist(1) oder eben nicht(0)
pc.have_map_scroll()
pc.have_pos_scroll()
pc.in_dungeon() -- Gibt zurück ob man greade in einem Dungeon ist(1) oder eben nicht(0)
pc.is_guild_master() -- Gibt zurück ob man Gilden Leader ist(1) oder eben nicht(0)
pc.is_horse_alive() -- Gibt zurück das Pferd des Spielers lebt(1) oder eben nicht(0)
pc.is_married() -- Gibt zurück ob man in verheiratet ist(1) oder eben nicht(0)
pc.is_mount()
pc.is_polymorphed() -- Gibt zurück ob man verwandelt ist(1) oder eben nicht(0)
pc.isguildmaster() -- Gibt zurück ob man Gilden Leader ist(1) oder eben nicht(0)
pc.mount(vnum,time) -- auf ein reittier aufsteigen
pc.pc_attract_ranger() -- abstand messen?
pc.polymorph(mob_vnum) -- Spieler Verwandeln
pc.refine_equip() -- Gegenstand Verbeßern
pc.remove_from_guild() -- Aus Gilde löschen
pc.remove_item(item_vnum) -- Gegenstand aus Inventar löschen
pc.remove_polymorph() -- Verwandlund rückgangig machen
pc.removeitem() -- Gegenstand aus Inventar löschen
pc.reset_point() -- Punkte zurück setzen (Status?)
pc.revive_horse()
pc.select() -- Auswahl
pc.set_part() -- Part wie Harr usw setzen
pc.set_warp_location()
pc.set_warp_location_local()
pc.setf() -- das selbe wie setqf
pc.setqf(name,value)
pc.set_skill_group() --Lehre wechseln
pc.set_skill_level() -- skill level ändern
pc.unmount() -- Vom reittier absteigen
pc.warp() -- Teleportieren
pc.warp_exit() -- Teleportieren (Ausgang)
pc.warp_local() -- Lokal warpen wie Tele Hack
pc.warp_to_guild_war_observer_position() -- Teleportieren zu Gildenkrieg wächter Typie
pc.is_clear_skill_group()
pc_find_skill_teacher_vid()
pc_find_square_guard_vid()
pc_get_exp_bonus() -- Gibt dem EXP Bonus aus
pc_get_village_map_index() -- gibt den map index des Dorfes aus
pc_is_novice() -- gibt aus ob der Spieler noch unter level 15 ist
raw_script()
restart_quest() -- Setzt den Quest State wieder auf Start
say() -- Einfaches [SAY]
say_npc_name() -- gibt Text mit Formatierung für den NPC Namen aus
say_pc_name() -- gibt Text mit Formatierung für den Spieler Namen aus
say_reward() -- gibt Text mit Formatierung für eine Belohnunh aus
say_title() -- gibt Text mit Formatierung für den Titel aus
say_item() -- gibt Text mit Formatierung für ein Item aus
say_item_vnum()--gibt Text mit Formatierung für ein Item aus<-Wie bei mt2de bei Schmied und Bio
select() -- Auswahl die Values müsst ihr selber machen Jede value = 1 auswahl feld wie Ja Nein
target.clear()
target.delete()
target.id()
target.npc()
target.pc()
target.pos()
target.vid()
test_chat()
time_hour_to_sec()
time_min_to_sec()
type()
pc.is_engaged() -- Ist der Spieler verlobt
string.format()
pc.is_gm() -- gibt aus ob der Spieler GM ist 1 oder 0
pc.get_gm_level() -- gibt das GM level zurück also implementor usw IMPLEMENTOR = 5 absteigend
pc.get_alignment()
pc.get_real_alignment()
pc.learn_grand_master_skill()
pc.is_skill_book_no_delay() -- wenn eine Exxo gelesen wurde 1 wenn nicht 0
pc.remove_skill_book_no_delay() -- entfernt den exxo effekt 


More when + with stuff
Thank you Risan for reminding me.

when use - part 1
So we make progress, now lets get startet with the item stuff.

normal:

PHP Code:

quest test begin
    when use begin
    
    end
end 


special method:

PHP Code:

quest test begin
    when itemvnum.use begin
    
    end
end 


These are the both methods i will go through each.

We begin with what you can do with use

The use event is cast when a player clicks on a item that has the type 18 you can make quests use able with the flag field in the database but i don't know if that works out correctly the flag would be 1024.

When the use event is cast, you have access to all commands item. commands binds the item you use to the item. commands. You can select other items with item.select. The use event allows you to make items that interact like there were hard coded. You can even use it as quest scrolls or things like that.

More about when use in when use part 2 and when use part 3

when use - part 2: The normal way
In the normal way you do it like this:

PHP Code:

quest test begin
    when itemvnum.use begin
        -- do something
    end
end 


If you want that more then one item does almost the same thing you can do something like this:

PHP Code:

quest test begin
    when itemvnum.use or item2vnum.use or item2vnum.use begin
        local type = item.get_value(0) -- local variable will be set to the value0 field of the item
        if type == 1 then
            syschat("You used item type1")
        elseif type==2 then
            syschat("You used item type1")
        elseif type==3    then
            syschat("You used item type1")
        end
    end
end 


This is only an example, you can later do the query with item.get_vnum(alias item.vnum) or other methods you decide how you want it.


MORE IS COMING SOON

[lautlosertot]

und bitte nochmal in deutch lolli^^

[Tyrar]

rly hobbylos

[[SGA]Jango]

Wenn man das nicht lesen kann also bitte der hat das wirklich sehr gut geschrieben!

[.Risan.]

Zeig auch gleich wie man gescheit os.execute mit mysql verbindet und arbeitet, daran hänge ich noch -.-

ansonsten nice.

wegem Quest-Editor nehme ich persönlich notepad+
Und Globale Variablen gehen bei Metin2 nicht.. Oder ich hab was Falsch gemacht...

[.Awesoome]

Jetzt sieht man mal wer im Englischunterrich aufgepasst hat

€: Kein Google Übersetzer benutzen !

[TheTutMan]

Schreibt Ymir seine ganzen Quests mit der Programmier sprache LUA?

[.Alpha.]

Extended the tutorial
Added the point conditionals with when and if


@TheTutMan
This question is already answered in the tutorial
Diese Frage wurde bereits im Tutorial beantwortet.

[TheTutMan]

Wenn ich es verstanden hätte würd ich nicht fragen.

[.Alpha.]

Ymir has only extended LUA it's their let's say quest language.
This means you could say they write their quests in LUA yes.

Ymir hat LUA nur erweitert, es ist ihre sagen wir Quest Sprache.
Das bedeutet du könntest sagen sie schreiben ihre Quests in LUA Ja.

[.Risan.]

Weiss ja nicht ob es was bringt, aber wenn einer mehre items gleiche funktion zuweissen will muss man nicht jedes mal:

PHP Code:

when VNUM1.use begin
-
end
when VNUM2.use begin
-
end
when VNUM3.use begin
-
end
when VNUM4.use begin
-
end 


Sondern kann auch:

PHP Code:

when VNUM1.use or VNUM2.use or VNUM3.use or VNUM.4.use begin
local item = item.get_vnum()
if item == VNUM1 then
--
elseif item == VNUM2 then
--
elseif item == VNUM3 then
--
else
--
end
end 


Hab bei vielen gesehen das die sehr viele when use haben obwohl alle selbe item beinnahe ist..

@Nova and os.execute() kannst dazu auch ein Tutrial machen?

[ѕηαρz уσυ.χ]

Originally Posted by .Nova.

WTF? Tables ? “something to sit on?!? xD”
No, I personally do not sit on tables I sit on chairs.

Sehr schönes Tutorial, echt gut erklärt, besonders für Anfänger, alles schön ausführlich und anschaulich da geboten.

ex. 101.kill = wilddog

Es ist zwar ein example, aber "zum Beispiel" wird im englischen doch mit "e.g." abgekürzt, oder irre ich mich?

[.Alpha.]

Originally Posted by ѕηαρz уσυ.χ

Sehr schönes Tutorial, echt gut erklärt, besonders für Anfänger, alles schön ausführlich und anschaulich da geboten.

Es ist zwar ein example, aber "zum Beispiel" wird im englischen doch mit "e.g." abgekürzt, oder irre ich mich?

Nein, du irrst nicht es wird nur ab und zu auch mit ex gemacht allerdings ist das falsch man könnte es Slang nennen

ex steht ja auch simpel und einfach für example

I suppose 'ex' would be a much less formal way of saying 'e.g.'

#Added point quest functions (translation of the comments in the list will come soon)

[.Marcel']

Ich finds gut das du alles in Englisch geschrieben hast.
So kanns am ende nicht jeder nub.

[.Alpha.]

#Added when use part 1-2 working on 3
#Later extending 2
#Next -> quest flags and other ways to save and edit data (flags, event flags, mysql reading, mysql writing, mysql deleting, textfiles)