Un **cooldown** e timpul de așteptare dintre două intrări în dungeon. Fără el, jucătorii activi fac dungeonul de zeci de ori pe zi, iar recompensele inundă economia. Cu un cooldown prost făcut, apar trucuri: „schimbă canalul și intri iar”, „schimbă liderul și merge”, „ieși înainte de boss și nu se numără”. În această lecție construim un cooldown salvat pe personaj, verificat pentru fiecare membru al grupului.
get_global_time()), iar la următoarea intrare verifici, pentru fiecare membru, dacă a trecut timpul. Cronometrul din interfață e doar informativ; serverul decide.Cuvinte pe care le vei întâlni
| Cuvânt | Ce înseamnă |
|---|---|
| Cooldown | Timpul minim de așteptare între două intrări. |
get_global_time() | Ora serverului, în secunde. Crește continuu, și după restart. |
pc.setqf / pc.getqf | Salvează și citește o valoare pe personaj, pentru questul curent. Rămâne după relogare și restart. |
| Politică | Regula aleasă: pe personaj, pe cont sau pe grup. |
Pasul 1: Alege politica
| Politică | Cum funcționează | Avantaj | Problemă |
|---|---|---|---|
| Pe personaj | Fiecare personaj are ora lui | Simplă, sigură, se face din quest | Un jucător cu 3 personaje intră de 3 ori |
| Pe cont | Toate personajele contului împart cooldown-ul | Limitează mai bine | În pachetul verificat nu există o funcție de quest pentru semne pe cont; cere modificări în sursă sau în baza de date |
| Pe grup | „Grupul” are cooldown | Pare logic | Grupul se poate desface și reface oricând, deci nu e o limită reală |
Recomandarea pentru început: cooldown pe personaj, verificat pentru fiecare membru al grupului. Așa face și dungeonul de foc din pachet.
De ce nu „pe grup”? Pentru că party.setf ține valoarea doar cât timp grupul există. Desfaci grupul, faci altul și cooldown-ul a dispărut.
Pasul 2: Ce face pachetul
În flame_dungeon.quest din pachetul verificat:
- la ieșire, ora e salvată pe personaj:
pc.setf("flame_dungeon", "exit_time", get_global_time()); - la intrare, liderul verifică toți membrii de pe hartă cu
party.is_map_member_flag_lt("exit_time", get_global_time() - ENTER_LIMIT_TIME * 60), adică „toți au ieșit acum mai mult de 30 de minute?”; - pentru teste există o opțiune care resetează timpul, vizibilă doar pe serverul de test, cu
with is_test_server().
E un model bun. Noi îl facem puțin mai simplu de citit.
Pasul 3: Verifică cooldown-ul fiecărui membru
Bucata de mai jos se pune în dialogul de intrare din lecția despre intrarea pentru party, după verificarea nivelului.
define COOLDOWN 3600
local pids = {party.get_member_pids()}
local blocati = {}
for i, pid in next, pids, nil do
q.begin_other_pc_block(pid)
local ramas = pc.getqf("ultima_intrare") + COOLDOWN - get_global_time()
if ramas > 0 then
table.insert(blocati, pc.get_name() .. " - mai are " .. math.ceil(ramas / 60) .. " min")
end
q.end_other_pc_block()
end
if table.getn(blocati) > 0 then
say("Acesti membri trebuie sa mai astepte:")
for i, text in next, blocati, nil do
say(text)
end
return
end| Bucată | Ce face, pe românește |
|---|---|
define COOLDOWN 3600 | Cooldown-ul e de 3600 de secunde, adică o oră. |
pc.getqf("ultima_intrare") | Ora ultimei intrări. Dacă n-a intrat niciodată, e 0. |
+ COOLDOWN - get_global_time() | Câte secunde mai are de așteptat. |
ramas > 0 | Dacă mai are de așteptat, îl trecem pe listă. |
math.ceil(ramas / 60) | Transformă secundele în minute, rotunjit în sus. |
Așa jucătorii văd cine blochează intrarea și cât mai are, nu doar un „nu poți intra”. Rândul cu define se pune la începutul fișierului, deasupra lui quest ... begin, ca în flame_dungeon.quest; restul intră în blocul when al dialogului.
Pasul 4: Când salvezi ora?
Aici se fac cele mai multe greșeli. Ai trei variante:
| Când salvezi | Ce se întâmplă |
|---|---|
| La intrare | Corect și simplu. Cine iese devreme nu „câștigă” o intrare în plus. |
| La terminare (boss mort) | Jucătorii ies înainte de boss, fac doar etajele ușoare și reintră imediat. |
La ieșire (when logout) | Funcționează (pachetul face așa), dar trebuie combinat cu verificări la intrare. |
Recomandarea: la intrare, chiar înainte de teleportare, pentru fiecare membru verificat:
for i, pid in next, pids, nil do
q.begin_other_pc_block(pid)
pc.setqf("ultima_intrare", get_global_time())
q.end_other_pc_block()
end
d.new_jump_party(MAPA_DUNGEON, 7762, 6739)Scrierea are loc într-o acțiune în joc (dialogul liderului), deci e sigură. Un compromis acceptat: dacă teleportarea eșuează (de exemplu, harta nu e încărcată pe acel core), cooldown-ul a fost deja pus. De aceea testezi intrarea pe serverul de test până merge de fiecare dată. Nu scrie niciodată semne de quest în when login: există un bug cunoscut al motorului care poate strica datele questurilor. Mai multe în quest flag-uri și condiții de nivel.
Atenție: pc.setqf și pc.getqf lucrează pe questul curent. Dacă verifici într-un quest și salvezi în altul, citești valori diferite. Ține tot cooldown-ul în același quest.
Pasul 5: De ce trucurile nu mai merg
| Trucul | De ce nu merge |
|---|---|
| Schimbă canalul | Ora e salvată pe personaj, în baza de date, nu pe canal. |
| Schimbă liderul | Fiecare membru e verificat, nu doar liderul. |
| Ies înainte de boss | Ora s-a salvat la intrare. |
| Restart la server | get_global_time() continuă să crească; ora salvată rămâne. |
| Modifică cronometrul din client | Serverul nu se uită la client. |
Ce ar trebui să vezi: după o intrare, același personaj nu mai poate intra o oră, indiferent de canal, lider sau relogare. După o oră, poate intra din nou.
Cum testezi fără să aștepți o oră
Pe serverul de test, pune temporar define COOLDOWN 120 (2 minute). Testează toate trucurile din tabel, apoi revino la valoarea reală. Poți adăuga și o opțiune de reset vizibilă doar pe test, ca în pachet, cu with is_test_server(). Despre testele la relogare și restart vezi testezi questurile la relogare și restart.
Greșeli des întâlnite
- Cooldown salvat la terminare. Jucătorii ies înainte de final și reintră.
- Verificat doar liderul. Ceilalți membri intră fără limită.
- Cooldown pe grup cu
party.setf. Dispare când grupul se desface. - Folosirea unui
timer()ca cooldown. Ceasurile de quest dispar la deconectare sau restart; o oră salvată nu. - Uitarea valorii de test. Rămâi cu cooldown de 2 minute pe serverul real.
Întrebări frecvente
Pot face „maxim 3 intrări pe zi” în loc de o oră?
Da. Salvezi pe personaj ziua curentă (de exemplu math.floor(get_global_time() / 86400)) și un contor. Dacă ziua s-a schimbat, resetezi contorul. Ține cont că ziua calculată așa începe la miezul nopții UTC, nu neapărat la ora României.
Cooldown-ul trebuie să fie și în client?
În client e doar pentru afișare, ca jucătorul să știe cât mai are. Regula reală e pe server.
Ce fac cu personajele multiple ale aceluiași jucător?
Din quest, în pachetul verificat, poți limita doar pe personaj. O limită pe cont cere modificări în sursă sau o tabelă separată în baza de date, testate cu grijă.
Ce urmează
Ce se întâmplă când cineva iese din joc în mijlocul dungeonului? Vezi deconectarea în dungeon.
Toate lecțiile sunt în lista tutorialelor Metin2.
Server Metin2 gata de joc
Găzduire Metin2 în România, cu instalare de serverfiles, bază de date MySQL și protecție Anti-DDoS inclusă.