BlueGit

timfa questward

Files

questward / client / src / play / quests.js

quests.js

quests.js 10.7 KiB Download Raw
1/**
2 * Play HUD Quests list + detail modals + completion popup + favorite tracker.
3 */
4import { formatObjectiveDisplayText } from "/shared/quests/objectiveProgress.js";
5import {
6 clearFavoriteQuestId,
7 loadFavoriteQuestId,
8 saveFavoriteQuestId
9} from "/shared/quests/favoriteQuest.js";
10
11export function initQuests ({ socket, MessageType, toasts })
12{
13 const listBackdrop = document.getElementById("quests-list-backdrop");
14 const listPanel = document.getElementById("quests-list-panel");
15 const listBody = document.getElementById("quests-list-body");
16 const detailBackdrop = document.getElementById("quests-detail-backdrop");
17 const detailPanel = document.getElementById("quests-detail-panel");
18 const detailTitle = document.getElementById("quests-detail-title");
19 const journalEl = document.getElementById("quests-detail-journal");
20 const stepEl = document.getElementById("quests-detail-step");
21 const completeBackdrop = document.getElementById("quest-complete-backdrop");
22 const completePanel = document.getElementById("quest-complete-panel");
23 const completeTitle = document.getElementById("quest-complete-title");
24 const completeBody = document.getElementById("quest-complete-body");
25 const trackerEl = document.getElementById("quest-tracker");
26 /** @type {any[]} */
27 let quests = [];
28 let listOpen = false;
29 let detailOpen = false;
30 let completeOpen = false;
31 let detailQuestId = null;
32 let localCharacterId = 0;
33 /** @type {string|null} */
34 let favoriteQuestId = null;
35
36 function showList (visible)
37 {
38 listOpen = visible;
39 if (listBackdrop)
40 { listBackdrop.hidden = !visible; }
41 if (listPanel)
42 { listPanel.hidden = !visible; }
43 if (visible)
44 { renderList(); }
45 }
46
47 function showDetail (visible, questId = null)
48 {
49 detailOpen = visible;
50 detailQuestId = visible ? questId : null;
51 if (detailBackdrop)
52 { detailBackdrop.hidden = !visible; }
53 if (detailPanel)
54 { detailPanel.hidden = !visible; }
55 if (visible)
56 { renderDetail(); }
57 }
58
59 function showComplete (visible, message = null)
60 {
61 completeOpen = visible;
62 if (completeBackdrop)
63 { completeBackdrop.hidden = !visible; }
64 if (completePanel)
65 { completePanel.hidden = !visible; }
66 if (!visible || !message)
67 { return; }
68 const title = String(message.title ?? "Quest").trim() || "Quest";
69 if (completeTitle)
70 { completeTitle.textContent = `"${title}" Completed!`; }
71 completeBody?.replaceChildren();
72 const ul = document.createElement("ul");
73 for (const entry of message.xp ?? [])
74 {
75 const li = document.createElement("li");
76 const amount = Math.max(0, Number(entry.amount) || 0);
77 const name = String(entry.displayName ?? entry.skillId ?? "Skill");
78 li.textContent = `+${amount} ${name} XP`;
79 ul.append(li);
80 }
81 for (const entry of message.items ?? [])
82 {
83 const li = document.createElement("li");
84 const qty = Math.max(1, Number(entry.quantity) || 1);
85 const name = String(entry.displayName ?? "Item");
86 li.textContent = qty > 1 ? `${qty}× ${name}` : name;
87 ul.append(li);
88 }
89 if (!ul.childElementCount)
90 {
91 const p = document.createElement("p");
92 p.className = "hint";
93 p.textContent = "Quest complete.";
94 completeBody?.append(p);
95 }
96 else
97 { completeBody?.append(ul); }
98 }
99
100 function canFavorite (quest)
101 {
102 return !!quest
103 && quest.state !== "completed"
104 && !quest.orphaned
105 && !!quest.step;
106 }
107
108 function setFavorite (questId)
109 {
110 const id = String(questId ?? "").trim() || null;
111 const quest = id ? quests.find((q) => q.questId === id) : null;
112 if (id && !canFavorite(quest))
113 { return; }
114 favoriteQuestId = id;
115 if (localCharacterId)
116 {
117 if (id)
118 { saveFavoriteQuestId(localCharacterId, id); }
119 else
120 { clearFavoriteQuestId(localCharacterId); }
121 }
122 if (listOpen)
123 { renderList(); }
124 renderTracker();
125 }
126
127 function toggleFavorite (questId)
128 {
129 if (favoriteQuestId === questId)
130 { setFavorite(null); }
131 else
132 { setFavorite(questId); }
133 }
134
135 function firstActiveObjective (quest)
136 {
137 if (!canFavorite(quest))
138 { return null; }
139 for (const obj of quest.step.objectives ?? [])
140 {
141 if (!obj?.done)
142 { return obj; }
143 }
144 return null;
145 }
146
147 function renderTracker ()
148 {
149 if (!trackerEl)
150 { return; }
151 const quest = favoriteQuestId
152 ? quests.find((q) => q.questId === favoriteQuestId)
153 : null;
154 if (!canFavorite(quest))
155 {
156 if (favoriteQuestId && localCharacterId)
157 {
158 favoriteQuestId = null;
159 clearFavoriteQuestId(localCharacterId);
160 }
161 trackerEl.hidden = true;
162 trackerEl.textContent = "";
163 return;
164 }
165 const obj = firstActiveObjective(quest);
166 if (!obj)
167 {
168 trackerEl.hidden = true;
169 trackerEl.textContent = "";
170 return;
171 }
172 const progress = (obj.current != null && obj.required != null)
173 ? { current: obj.current, required: obj.required }
174 : null;
175 trackerEl.textContent = formatObjectiveDisplayText(obj.text, progress);
176 trackerEl.hidden = false;
177 }
178
179 function renderList ()
180 {
181 if (!listBody)
182 { return; }
183 listBody.replaceChildren();
184 if (!quests.length)
185 {
186 const empty = document.createElement("p");
187 empty.className = "hint";
188 empty.textContent = "No quests yet.";
189 listBody.append(empty);
190 return;
191 }
192 for (const quest of quests)
193 {
194 const row = document.createElement("div");
195 row.className = "quests-list-row";
196 const btn = document.createElement("button");
197 btn.type = "button";
198 btn.className = "quests-list-item";
199 const status = quest.state === "completed"
200 ? "Completed"
201 : (quest.orphaned ? "Unavailable" : "Active");
202 btn.textContent = `${quest.title} — ${status}`;
203 btn.addEventListener("click", () =>
204 {
205 showList(false);
206 showDetail(true, quest.questId);
207 });
208 const star = document.createElement("button");
209 star.type = "button";
210 star.className = "quests-favorite-btn";
211 const isFav = favoriteQuestId === quest.questId;
212 const allowed = canFavorite(quest);
213 star.textContent = isFav ? "★" : "☆";
214 star.title = !allowed
215 ? "Only active quests can be favorited"
216 : (isFav ? "Clear favorite" : "Favorite quest");
217 star.disabled = !allowed && !isFav;
218 star.setAttribute("aria-pressed", isFav ? "true" : "false");
219 if (isFav)
220 { star.classList.add("active"); }
221 star.addEventListener("click", (event) =>
222 {
223 event.preventDefault();
224 event.stopPropagation();
225 if (!allowed && !isFav)
226 { return; }
227 toggleFavorite(quest.questId);
228 });
229 row.append(btn, star);
230 listBody.append(row);
231 }
232 }
233
234 function renderDetail ()
235 {
236 const quest = quests.find((q) => q.questId === detailQuestId);
237 if (!quest)
238 {
239 if (detailTitle)
240 { detailTitle.textContent = "Quest"; }
241 journalEl?.replaceChildren();
242 stepEl?.replaceChildren();
243 return;
244 }
245 if (detailTitle)
246 { detailTitle.textContent = quest.title; }
247
248 journalEl?.replaceChildren();
249 const journal = quest.journal ?? [];
250 if (!journal.length)
251 {
252 const empty = document.createElement("p");
253 empty.className = "hint";
254 empty.textContent = "No journal entries yet.";
255 journalEl?.append(empty);
256 }
257 else
258 {
259 for (const entry of journal)
260 {
261 const p = document.createElement("p");
262 p.className = "quests-journal-entry";
263 p.textContent = entry.text || "";
264 journalEl?.append(p);
265 }
266 }
267
268 stepEl?.replaceChildren();
269 if (quest.state === "completed")
270 {
271 const done = document.createElement("p");
272 done.textContent = "Quest complete.";
273 stepEl?.append(done);
274 return;
275 }
276 if (quest.orphaned || !quest.step)
277 {
278 const miss = document.createElement("p");
279 miss.className = "hint";
280 miss.textContent = quest.description || "Quest data unavailable.";
281 stepEl?.append(miss);
282 return;
283 }
284 const title = document.createElement("h3");
285 title.textContent = quest.step.title || "Current step";
286 const desc = document.createElement("p");
287 desc.textContent = quest.step.description || "";
288 stepEl?.append(title, desc);
289 const ul = document.createElement("ul");
290 ul.className = "quests-objectives";
291 for (const obj of quest.step.objectives ?? [])
292 {
293 const li = document.createElement("li");
294 const progress = (obj.current != null && obj.required != null)
295 ? { current: obj.current, required: obj.required }
296 : null;
297 li.textContent = formatObjectiveDisplayText(obj.text, progress);
298 if (obj.done)
299 { li.classList.add("done"); }
300 ul.append(li);
301 }
302 stepEl?.append(ul);
303 }
304
305 document.getElementById("quests-toggle")?.addEventListener("click", () =>
306 {
307 if (listOpen)
308 { showList(false); }
309 else
310 {
311 showDetail(false);
312 socket.send({ type: MessageType.requestQuests });
313 showList(true);
314 }
315 });
316 document.getElementById("quests-list-close")?.addEventListener("click", () => showList(false));
317 listBackdrop?.addEventListener("click", () => showList(false));
318 document.getElementById("quests-detail-close")?.addEventListener("click", () => showDetail(false));
319 document.getElementById("quests-detail-back")?.addEventListener("click", () =>
320 {
321 showDetail(false);
322 showList(true);
323 });
324 detailBackdrop?.addEventListener("click", () => showDetail(false));
325 document.getElementById("quest-complete-ok")?.addEventListener("click", () => showComplete(false));
326 completeBackdrop?.addEventListener("click", () => showComplete(false));
327
328 return {
329 isBlocking ()
330 {
331 return listOpen || detailOpen || completeOpen;
332 },
333 setLocalCharacterId (characterId)
334 {
335 localCharacterId = characterId | 0;
336 favoriteQuestId = loadFavoriteQuestId(localCharacterId);
337 renderTracker();
338 if (listOpen)
339 { renderList(); }
340 },
341 applySnapshot (message)
342 {
343 quests = Array.isArray(message?.quests) ? message.quests : [];
344 if (favoriteQuestId)
345 {
346 const fav = quests.find((q) => q.questId === favoriteQuestId);
347 if (!canFavorite(fav))
348 {
349 favoriteQuestId = null;
350 if (localCharacterId)
351 { clearFavoriteQuestId(localCharacterId); }
352 }
353 }
354 if (listOpen)
355 { renderList(); }
356 if (detailOpen)
357 { renderDetail(); }
358 renderTracker();
359 },
360 handleStepComplete (message)
361 {
362 const questId = message?.questId;
363 toasts?.show("Quest objectives achieved", {
364 onClick: () =>
365 {
366 showList(false);
367 if (questId)
368 { showDetail(true, questId); }
369 }
370 });
371 },
372 handleObjectiveComplete (message)
373 {
374 const questId = message?.questId;
375 const label = String(message?.text ?? "").trim() || "Objective";
376 toasts?.show(`Objective completed:\n${label}`, {
377 onClick: () =>
378 {
379 showList(false);
380 if (questId)
381 { showDetail(true, questId); }
382 }
383 });
384 },
385 handleComplete (message)
386 {
387 if (message?.questId && favoriteQuestId === message.questId)
388 { setFavorite(null); }
389 showComplete(true, message);
390 },
391 openQuest (questId)
392 {
393 showList(false);
394 showDetail(true, questId);
395 },
396 hide ()
397 {
398 showList(false);
399 showDetail(false);
400 showComplete(false);
401 },
402 reset ()
403 {
404 quests = [];
405 localCharacterId = 0;
406 favoriteQuestId = null;
407 this.hide();
408 renderTracker();
409 }
410 };
411}