Description
SessionReceipt 🧾
Authentic Supermarket & Fiscal Thermal Paper Receipt for World of Warcraft
💡 What is SessionReceipt?
SessionReceipt is an ultralight, passive World of Warcraft addon that captures and summarizes your gaming session in the style of an authentic supermarket thermal printer receipt from AZEROTH MART.
Whenever you log out, quit the game, or type /receipt (or /paragon), an interactive thermal paper summary pops up on your screen. It features realistic perforated tear edges, a drop shadow, monospaced thermal dot-matrix typography, a generated character GUID barcode, and a detailed breakdown of your session earnings, expenses, hourly efficiency, work accidents (deaths), bounties (kills), and valuable drops.
It is designed for viral sharing on Discord, guild chats, and social media!
✨ Key Features
1. 🛑 City & Inn Logout Interceptor (No Instant Disconnect!)
In resting areas (cities and inns), World of Warcraft normally disconnects your character instantly in 0.0 seconds without giving you a chance to check your session or take a screenshot. SessionReceipt solves this completely:
- When clicking Log Out or Exit Game in the Game Menu (Esc) or typing
/logout, SessionReceipt pauses the instant disconnect and displays your receipt with a 10-second countdown (Logging out in 10s...). - Interactive Bottom Buttons:
- [Log Out Now] / [Exit Now]: Click to disconnect immediately if you don't wish to wait.
- [Cancel]: Abort logout and instantly return to gameplay.
- [Print to Chat]: Instant formatted broadcast to your party, raid, or guild.
- Custom countdown delay can be configured anytime:
/receipt delay [3-60].
2. ⚡ 100% Zero-Lag & Passive Architecture (Zero OnUpdate)
- Zero CPU polling: There are NO
OnUpdaterunning loops anywhere in the code. - Smart Money Snapshot: Does not track every copper transaction. Computes net profit (
deltaGold) cleanly on demand, with built-in race condition protection againstGetMoney() == 0during initial login. - Sane Hourly Efficiency: Gold/hour density is safely calculated only after at least 2 minutes of gameplay, preventing absurd rates.
3. 🧾 Authentic Fiscal Receipt Aesthetic
- Custom off-white thermal paper palette (
#F5F5ED) with 1px border and realistic drop shadow. - Serrated top and bottom paper cutter blades (
/\/\/\/\/\/\/\/\/\/\/\) and perforation dash lines (- - - -). - Centered fiscal terminal header:
*** AZEROTH MART ***, cashier name, date, realm, and terminal ID. - Generated barcode with player GUID and thermal slogan: "THANK YOU FOR PLAYING!" / "DZIEKUJEMY ZA WSPOLNA GRE!".
- Placed on
FULLSCREEN_DIALOGstrata (Level 100) — always rendered cleanly in front of all interface elements.
4. 💎 Notable Loot Vault (Rare & Epic Filter)
- Passively listens to
CHAT_MSG_LOOTand filters drops of quality Rare (Blue), Epic (Purple), and Legendary (Orange). - Interactive receipt rows: hover over items to see their live in-game tooltips, or Shift-click to paste item links into chat!
- Hardcoded 5-item FIFO ring buffer prevents memory bloat even during 12-hour continuous farming sessions.
5. 💬 One-Click Discord & Chat Export
Click the subtle [Print to Chat] button to output a compressed, Discord-ready summary to your current group (Raid, Party, Guild, or Say):
[SessionReceipt]: 2h 15m in game - Profit: +43g 52s - Deaths: 2 - Kills: 148 - Best drop: [Felstriker]
(Shift-Clicking the button forces output directly to Guild chat!)
6. 🌐 Instant Dual Language Support (English & Polish)
- Interactive [PL] / [EN] language switch button right in the top-left corner of the receipt!
- Instant live re-render without reloading UI.
- Switch via command:
/receipt lang(toggle) or/receipt lang [en|pl]. - Settings and selected language are automatically saved across sessions (
SessionReceiptDB).
💻 Slash Commands
| Command | Description |
|---|---|
/receipt or /paragon |
Toggle / view receipt window anytime during your session |
/receipt test |
Preview demo receipt with authentic epics and stats (safe, does not touch live session) |
/receipt share |
Post compressed receipt summary to current chat channel |
/receipt reset |
Reset current session counters and gold snapshot |
/receipt delay [sec] |
Set city logout countdown timer (3–60s, default: 10s) |
/receipt lang |
Toggle language between English and Polish (or click [PL]/[EN] in UI) |
/receipt lang [en\|pl] |
Switch to specific language: English (en) or Polish (pl) |
/receipt help |
Display in-game command reference |
(You can also use /paragon or /sr as command aliases!)
🎯 Cross-Client Compatibility
SessionReceipt uses Zero-Dependency architecture (pure Lua 5.0/5.1 and native FrameXML) with backward compatibility across all modern and legacy Classic flavors:
- WoW Forever (1.60.1 / 1.60)
- WoW Classic Era (1.14.x / 1.15.x)
- Season of Discovery (SoD)
- Hardcore & Hardcore Self-Found
- Vanilla 1.12.1 (Legacy / Retro Clients)
🛠️ Installation
- Download
SessionReceipt-v1.0.1.zip. - Extract the archive into your World of Warcraft directory:
World of Warcraft\_classic_era_\Interface\AddOns\SessionReceipt\
(or_forever_\Interface\AddOns\SessionReceipt\) - Ensure the folder is named exactly:
SessionReceipt. - Launch the game or type
/reloadin chat. - Enjoy your receipts!
❓ Frequently Asked Questions (FAQ)
Q: Does SessionReceipt impact my FPS or combat performance?
A: Absolutely not! The addon has zero OnUpdate scripts and executes zero calculations during combat. Calculations are performed on-demand only when opening the receipt or logging out.
Q: Can I change how long the city logout countdown lasts?
A: Yes! Type /receipt delay 15 (or any number between 3 and 60 seconds). Your preference is saved permanently.
Q: How do I share my receipt with guildies?
A: Click the [Print to Chat] button on the receipt, or Shift-Click it to force sending directly to Guild chat. You can also press PrintScreen to capture the beautiful receipt image for Discord!
===========
SessionReceipt 🧾
Autentyczny Paragon Fiskalny z Drukarki Termicznej dla World of Warcraft
💡 Czym jest SessionReceipt?
SessionReceipt to ultralekki, w 100% pasywny addon dla World of Warcraft, który działa cicho w tle i podsumowuje każdą Twoją sesję w grze w formie autentycznego paragonu z kasy fiskalnej / drukarki termicznej ze słynnego marketu AZEROTH MART.
W momencie wylogowania postaci, wyjścia z gry lub wpisania komendy /paragon (lub /receipt), na środku ekranu pojawia się stylowy paragon fiskalny. Zawiera on realistyczne ząbkowane krawędzie odcinacza papieru, perforację, miękki cień, typografię igłową/termiczną, generowany kod kreskowy z unikalnym GUID-em Twojej postaci oraz szczegółowe zestawienie: zarobione złoto, koszty, efektywność na godzinę (złoto/h), wypadki przy pracy (zgony), zlecenia (zabójstwa) oraz najcenniejsze zdobyte przedmioty (epiki i rzadkie itemy).
Addon został stworzony z myślą o błyskawicznym dzieleniu się wynikami na Discordzie, czacie gildii oraz mediach społecznościowych!
✨ Kluczowe Funkcje
1. 🛑 Koniec z przypadkowym natychmiastowym wylogowaniem w mieście!
W miastach i karczmach (Resting Areas) World of Warcraft normalnie rozłącza postać w 0.0 sekundy — zanim zdążysz sprawdzić statystyki sesji lub zrobić zrzut ekranu. SessionReceipt rozwiązuje ten problem całkowicie:
- Kliknięcie przycisku Wyloguj lub Wyjdź z gry w menu gry (Esc) lub wpisanie
/logoutwstrzymuje natychmiastowe rozłączenie i wyświetla paragon z 10-sekundowym odliczaniem (Wylogowanie za 10s...). - Interaktywne przyciski na dole paragonu:
- [Wyloguj Teraz] / [Wyjdź Teraz]: Kliknij, aby natychmiast opuścić grę, jeśli nie chcesz czekać.
- [Anuluj]: Anuluj wylogowanie i natychmiast powróć do rozgrywki.
- [Drukuj na Czat]: Błyskawiczny, sformatowany raport na czat grupy lub gildii.
- Czas odliczania możesz w każdej chwili dostosować:
/paragon delay [3-60](np./paragon delay 15).
2. ⚡ 100% Zero-Lag i Pasywna Architektura (Brak OnUpdate)
- Zero obciążenia procesora: W kodzie addonu NIE MA żadnych działających w tle pętli
OnUpdate. - Inteligentny bilans majątku: Addon nie śledzi każdego pojedynczego miedziaka w locie. Bilans zysku netto (
deltaGold) obliczany jest pasywnie dopiero w chwili wywołania paragonu, ze specjalnym zabezpieczeniem przed błędemGetMoney() == 0podczas logowania do świata gry. - Realistyczna efektywność godzinowa: Wskaźnik złoto/godzinę kalkulowany jest dopiero po upływie co najmniej 2 minut rozgrywki, co eliminuje absurdalne, nierealistyczne wartości.
3. 🧾 Autentyczny Wygląd Paragonu Fiskalnego
- Kolorystyka prawdziwego papieru termicznego (
#F5F5ED) z delikatnym obramowaniem 1px i miękkim cieniem. - Ząbkowane noże odcinacza papieru na górze i dole (
/\/\/\/\/\/\/\/\/\/\/\) oraz linie perforacji (- - - -). - Nagłówek kasy fiskalnej:
*** AZEROTH MART ***, kasjer (Twoja postać), data, serwer i numer kasy fiskalnej. - Unikalny kod kreskowy z GUID-em postaci oraz slogan: "DZIEKUJEMY ZA WSPOLNA GRE!".
- Warstwa ekranu:
FULLSCREEN_DIALOG(poziom 100) — paragon zawsze wyświetla się na samym wierzchu interfejsu.
4. 💎 Rejestr Cennego Łupu (Notable Loot)
- Pasywnie nasłuchuje komunikatów o łupach i filtruje przedmioty jakości Rzadkiej (Niebieskie), Epickiej (Fioletowe) oraz Legendarnej (Pomarańczowe).
- Interaktywne wiersze: najedź myszką na przedmiot na paragonie, aby zobaczyć oryginalny tooltip z gry, lub kliknij z wciśniętym klawiszem Shift, aby wkleić link do przedmiotu na czat!
- Sztywny bufor pamięci na 5 przedmiotów (FIFO) gwarantuje zerowe zużycie RAM-u nawet podczas 12-godzinnych maratonów farmy.
5. 💬 Błyskawiczny Eksport na Czat i Discorda
Wystarczy kliknąć przycisk [Drukuj na Czat], aby wysłać estetyczne podsumowanie na aktualny kanał (Raid, Grupa, Gildia lub Say):
[SessionReceipt]: 2h 15m w grze - Zysk: +43g 52s - Zgony: 2 - Kills: 148 - Najlepszy drop: [Felstriker]
(Wciśnięcie klawisza Shift przy kliknięciu wymusza wysyłkę bezpośrednio na czat gildyjny!)
6. 🌐 Pełna Obsługa Języka Polskiego i Angielskiego
- Przycisk [PL] / [EN] bezpośrednio w lewym górnym rogu okna paragonu!
- Zmiana języka następuje natychmiast na żywo bez potrzeby przeładowywania gry (
/reload). - Dostępna także komenda:
/paragon lang(przełącznik) lub/paragon lang [pl|en]. - Wybrany język oraz ustawienia są automatycznie zapisywane w pliku konfiguracyjnym (
SessionReceiptDB).
💻 Komendy w Grze (Slash Commands)
Wpisz na czacie /paragon, /receipt lub /sr:
| Komenda | Działanie |
|---|---|
/paragon lub /receipt |
Pokazuje lub ukrywa okno paragonu bieżącej sesji |
/paragon test |
Ładuje przykładowy paragon demonstracyjny z epikami i zyskiem (bezpieczny test) |
/paragon share |
Wysyła skrócone podsumowanie sesji na aktualny kanał czatu |
/paragon reset |
Zeruje liczniki sesji (przydatne np. przed rozpoczęciem nowego rajdu lub farmy) |
/paragon delay [sek] |
Ustawia czas odliczania w mieście (3–60 sek, domyślnie: 10s) |
/paragon lang |
Błyskawicznie przełącza język (PL / EN) – lub kliknij przycisk [PL]/[EN] |
/paragon lang [pl\|en] |
Wymusza konkretny język: polski (pl) lub angielski (en) |
/paragon pomoc |
Wyświetla listę dostępnych komend w grze |
🎯 Kompatybilność z Wersjami Gry
SessionReceipt powstał w standardzie Zero-Dependency (czysty Lua 5.0/5.1 + natywne FrameXML) i działa bez jakichkolwiek zewnętrznych bibliotek na wszystkich odmianach Classic:
- WoW Forever (1.60.1 / 1.60)
- WoW Classic Era (1.14.x / 1.15.x)
- Season of Discovery (SoD)
- Hardcore & Hardcore Self-Found
- Vanilla 1.12.1 (Klient klasyczny 1.12)
🛠️ Instrukcja Instalacji Krok po Kroku
- Pobierz plik
SessionReceipt-v1.0.1.zip. - Wypakuj archiwum do folderu z dodatkami World of Warcraft:
World of Warcraft\_classic_era_\Interface\AddOns\SessionReceipt\
(lub_forever_\Interface\AddOns\SessionReceipt\) - Upewnij się, że folder nazywa się dokładnie:
SessionReceipt. - Włącz grę lub wpisz
/reloadna czacie. - Ciesz się automatycznymi paragonami po każdej udanej sesji!
❓ Najczęściej Zadawane Pytania (FAQ)
Czy addon wpływa na liczbę klatek (FPS) w rajdach i dungeonach?
Nie! SessionReceipt nie ma ani jednej linijki pętli OnUpdate. Addon nie wykonuje żadnych obliczeń w trakcie walki — kalkulacje uruchamiają się tylko wtedy, gdy otworzysz okno paragonu lub klikniesz wylogowanie.
Czy mogę zmienić czas odliczania w mieście?
Tak! Wpisz /paragon delay 15 (lub dowolną liczbę od 3 do 60 sekund). Wybrany czas zostanie zapamiętany na stałe.
Jak zrobić ładny zrzut ekranu paragonu na Discorda?
Wpisz /paragon, naciśnij klawisz PrintScreen na klawiaturze i wklej zrzut bezpośrednio na swój kanał Discorda!




