🎯 Hybrid Alert Positioning (Issue #32)

🕉️ MOKSHA — DevLog v0.0.9

"प्रारब्धं भुज्यते एव — भोगना ही पड़ता है।"

Release: v0.0.9 — Prarabdha Refinements + Alert System + Hybrid Positioning

Date: July 2026

Developer: @weirdcodesofficial

Play: weirdcodes.itch.io/moksha

Support: ko-fi.com/weirdcodes

---

📜 प्रारब्ध — भोगना ही मार्ग है

v0.0.9 का सबसे गहरा feature प्रारब्ध mechanic का refinement है।

Sanatan Shastra में प्रारब्ध वह कर्म है जो पहले से ही फलने लगा है — उसे न जलाया जा सकता है, न टाला जा सकता है। बस भोगना पड़ता है।

Game में इसे इस तरह implement किया:

MAX_PRARABDHA = 15 — अधिकतम सीमा तय की। अनंत प्रारब्ध से game unplayable हो जाता — शास्त्र भी कहते हैं कि कर्म का फल असीमित नहीं होता।

Bhog Penalty ×1.15 — जब प्रारब्ध भोग जारी हो, समय थोड़ा तेज़ घटता है। भोग की पीड़ा gameplay में महसूस होती है।

10 नाम = 2× भोग-गति — नाम-जाप से प्रारब्ध नष्ट नहीं होता लेकिन भोग तेज़ होता है। यह गीता के "नाम जपत मंगल दिसि दसहूँ" से प्रेरित है।

Unit break explosion — जब एक प्रारब्ध unit भोग पूरा होती है तो purple explosion होती है। पूर्ण मुक्ति पर pink glow। दृश्य feedback भावनात्मक moment को highlight करता है।

---

👁️ चेतना-जागृति → कर्म-रक्षा

गीता 4.37: "ज्ञानाग्निः सर्वकर्माणि भस्मसात् कुरुते"

जब samarpita ≥ 50 पूरा होता है — चेतना जागती है और अब isKarmaImmune = true हो जाता है। माया का कर्म-प्रभाव शून्य। जागृत आत्मा पर कर्म-बंधन नहीं लगता।

यह reincarnation में भी carry होता है — जागृत चेतना जन्म-जन्मांतर बनी रहती है।

---

🔔 Alert System — Complete Overhaul

v0.0.8 में canvas alert queue बनी थी। v0.0.9 में उसे mature किया:

Alert flooding बंद — पहले हर second एक alert fire होती थी। अब सिर्फ meaningful events पर।

Chain break alerts — पुण्य या पाप chain टूटने पर बंधन-मुक्त alert + bandhanaMukta sound। शास्त्र-संगत feedback।

Icon audit — हर alert का icon सही किया:

• 🛑 वैराग्य → 🪷 (detachment = lotus, stop sign नहीं)
• 🚨 पाप हमला → 🥀 (paap = wilted flower)
• 💧 पाप भस्म → 🔥 (burning away = fire)
• 🙏 कृपा → ✋ (kripa = grace, not namaste)

DOM alertBox हटाया — सभी alerts अब canvas पर हैं।

---

🎯 Hybrid Alert Positioning (Issue #32)

यह v0.0.9 का सबसे interesting UX decision था।

समस्या: corner alerts देखने के लिए नज़र हटानी पड़ती है — immersion टूटता है।

पहला idea (#29): सब alerts player के ऊपर। लेकिन player के ऊपर पहले से punyaTimer pill, prarabdhaTimer pill, floating texts, naam-jaapa ring हैं — और clutter बढ़ता।

Solution (#32) — Hybrid System:

Category	Position	Style
warning / guidance	Player के ऊपर compact pill	Icon + 1 line
achievement / info	Top-right full card	Title + subtitle

Action-critical alerts (पाप हमला, चक्रवात, दृष्टि blocked) → player के पास।
Milestone alerts (चेतना जागृत, 50 समर्पित) → corner पर पढ़ने का समय है।

---

🏗️ Build System

पहले हर बार manually esbuild command लिखनी पड़ती थी। अब:

npm run dev     # development — auto-rebuild on save
npm run build   # production — minified
npm run package # build + zip — itch.io ready

dist/ और *.zip को .gitignore में add किया — source code clean रहे।

---

🐛 Production Readiness

Release से पहले comprehensive audit किया:

• ctx.roundRect() polyfill — Chrome < 99 support
• Reincarnation पर isNaamaJaapa, _prevSamaya200 reset
• console.log debug statements हटाए
• bandhanaMukta audio key typo fix

---

🛣️ आगे क्या?

✅ v0.0.9 — Prarabdha refinements (done)
⬜ v0.1.0 — Pankhudi directional mechanics

v0.1.0 पहला major gameplay overhaul होगा। Pankhudi की active direction से power shoot, maya pull, और indriya pull drive होंगे। यह game का core mechanic है जो अभी तक missing है।

---

📦 Commit

https://github.com/weirdcodesofficial/MOKSHA/commit/2898adce623d46747c13a019d80db63a03208e8a

---

🙏 समर्पण

MOKSHA एक solo project है — code, design, audio, philosophy — सब कुछ अकेले।

अगर यह journey अच्छी लगी तो:

• ⭐ GitHub पर Star करो
• ☕ Ko-fi पर support करो
• 🎮 itch.io पर खेलो

ॐ नमः शिवाय 🕉️

---

MOKSHA