OPJobTracker

# 🚀 OP Job Tracker 1.0.2

> **Major feature update for OPSUCHT**
>
> Version 1.0.2 expands OP Job Tracker with **Job Treasures, special-block statistics, compressor tracking and a complete dynamic Shard Dealer system**.

---

# 🇬🇧 English

## ✨ Highlights

### 🎁 Job Treasure Tracking

OP Job Tracker can now track **Job Treasures** on OPSUCHT.

The new treasure statistics include:

- Treasures found in the selected period
- Treasures found today
- All-time treasure count
- Treasures found during the current session
- Time of the last treasure

Job Treasure detection has been adapted to the real OPSUCHT server messages and includes protection against duplicate detections.

---

## 🎁 Treasure Reward Tracking

Opening a Job Treasure can now be tracked as well.

Supported rewards include:

- 💰 Money
- 💎 OPShards
- ⭐ Job XP
- ⚡ Job XP Boosters
- 💵 Job Money Boosters

Booster percentage and duration are taken directly from the real OPSUCHT reward message.

### ⭐ Treasure Job XP

Job XP received from a Job Treasure is assigned to the corresponding job.

Supported jobs:

- Miner
- Lumberjack
- Digger
- Hunter
- Fisher
- Farmer
- Builder

Treasure XP is stored separately from normal farming XP.

This means:

**Treasure rewards do not artificially increase normal XP/hour statistics or farming performance.**

---

## 🧱 Special Block Statistics

Version 1.0.2 adds additional statistics for special blocks.

### 🕸️ Spawners

Spawner tracking has been added to the statistics.

You can now keep track of how many Spawners you have collected during your tracked periods.

### 🪨 Reinforced Deepslate

Reinforced Deepslate is now tracked separately.

The tracker also calculates the equivalent amount of complete Ancient City frames.

**56 Reinforced Deepslate = 1 complete frame**

Remaining blocks are displayed separately.

Example:

`123 Reinforced Deepslate → 2 frames + 11 blocks`

---

# 💎 Schätze / Shards Dashboard

The previous treasure area has been expanded into a combined:

## **Schätze / Shards**

dashboard.

It combines:

- Job Treasure statistics
- Treasure reward history
- Treasure Job XP
- Shard Dealer product statistics
- Shard Dealer exchange statistics

All values follow the selected statistics period where applicable.

---

## 📦 Compressor Product Tracking

OP Job Tracker can now detect products created with the OPSUCHT compressor.

Tracked products:

| Product | Tracked |
| --- | ---: |
| Steinplatten | ✅ |
| Holzbündel | ✅ |
| Gräbergemisch | ✅ |

Only actual compressor production is counted.

The detection is designed to avoid false statistics caused by:

- dropping and picking the finished product up again
- taking products from chests
- buying products from shop chests
- moving items inside the inventory
- receiving finished products from another player

The tracker also handles situations where part of the required raw material was already present in the inventory before the compressor created the product.

---

## 💱 Shard Dealer Exchange Tracking

Items exchanged for OPShards can now be tracked separately.

Supported exchange items:

| Item | Amount exchanged | OPShards received |
| --- | ---: | ---: |
| Steinplatten | ✅ | ✅ |
| Holzbündel | ✅ | ✅ |
| Gräbergemisch | ✅ | ✅ |
| Diamond Blocks | ✅ | ✅ |
| Netherite Ingots | ✅ | ✅ |

The tracker records both:

- the number of items exchanged
- the actual amount of OPShards received

---

## 🕒 Period Statistics

The new treasure and Shard Dealer statistics integrate with the existing period system:

- Hour
- Day
- Week
- Month
- Year
- All time

This makes it possible to compare both your Job Treasure activity and Shard Dealer exchanges over time.

---

## 🛠️ Improvements & Fixes

- Improved Job Treasure detection for real OPSUCHT server messages
- Added duplicate protection for treasure detection
- Player chat messages cannot falsely increase the treasure counter
- Minecraft formatting codes are removed before treasure rewards are parsed
- Improved Job Treasure reward parsing
- Job Treasure XP is displayed separately for each job
- Treasure XP no longer affects normal XP/hour statistics
- Improved Job XP dashboard layout
- Added dedicated **Schätze / Shards** dashboard
- Added compressor product tracking
- Improved compressor detection across delayed inventory updates
- Improved compressor detection when materials were already present
- Added protection against false compressor statistics
- Added dynamic Shard Dealer exchange tracking
- Fixed detected Shard Dealer trades displaying as `0`
- Improved profile-safe storage for Shard Dealer statistics
- Improved responsive dashboard layout

---

## 🎮 Compatibility

OP Job Tracker 1.0.2 is available for:

- **Minecraft 1.21.11**
- **Minecraft 26.1.x**
- **Minecraft 26.2**

### Requirements

- Fabric Loader
- Fabric API
- Client-side installation only
- Java version depends on the Minecraft version

No server-side installation is required.

> OP Job Tracker is an independent community project and is not an official OPSUCHT modification.

---

# 🇩🇪 Deutsch

## ✨ Highlights

### 🎁 Jobschatz-Tracking

OP Job Tracker kann jetzt **Jobschätze auf OPSUCHT** erfassen.

Die neuen Schatzstatistiken zeigen:

- gefundene Jobschätze im gewählten Zeitraum
- heute gefundene Jobschätze
- Gesamtzahl aller Jobschätze
- Jobschätze der aktuellen Session
- Zeitpunkt des letzten Fundes

Die Erkennung wurde an die echten OPSUCHT-Servermeldungen angepasst und besitzt einen Schutz gegen doppelte Erfassungen.

---

## 🎁 Jobschatz-Belohnungen

Auch die Belohnungen beim Öffnen eines Jobschatzes können jetzt ausgewertet werden.

Unterstützt werden:

- 💰 Geld
- 💎 OPShards
- ⭐ Job-XP
- ⚡ Job-XP-Booster
- 💵 Jobgeld-Booster

Bei Boostern werden Prozentwert und Laufzeit direkt aus der echten OPSUCHT-Belohnungsmeldung übernommen.

### ⭐ Jobschatz-XP

Job-XP aus Jobschätzen werden dem jeweiligen Job zugeordnet.

Unterstützte Jobs:

- Minenarbeiter
- Holzfäller
- Gräber
- Jäger
- Fischer
- Farmer
- Builder

Die Jobschatz-XP werden getrennt von den normalen Farm-XP gespeichert.

Dadurch gilt:

**Jobschatz-Belohnungen verfälschen weder deine normalen XP pro Stunde noch deine tatsächliche Farmleistung.**

---

## 🧱 Spezialblock-Statistiken

Version 1.0.2 erweitert das Tracking um zusätzliche Spezialblöcke.

### 🕸️ Spawner

Spawner werden nun separat erfasst und können über die vorhandenen Statistikzeiträume ausgewertet werden.

### 🪨 Verstärkter Tiefenschiefer

Auch **Verstärkter Tiefenschiefer** wird jetzt separat gezählt.

Zusätzlich berechnet OP Job Tracker daraus automatisch die Anzahl kompletter Ancient-City-Rahmen.

**56 Verstärkter Tiefenschiefer = 1 kompletter Rahmen**

Übrig gebliebene Blöcke werden zusätzlich angezeigt.

Beispiel:

`123 Verstärkter Tiefenschiefer → 2 Rahmen + 11 Blöcke`

---

# 💎 Schätze / Shards

Der bisherige Schatzbereich wurde zu einem gemeinsamen:

## **Schätze / Shards**

Dashboard erweitert.

Dort findest du jetzt:

- Jobschatz-Statistiken
- Belohnungsverlauf
- Jobschatz-XP
- Shardhändler-Produktion
- Shardhändler-Tauschstatistiken

Die Werte richten sich, soweit möglich, nach dem aktuell ausgewählten Statistikzeitraum.

---

## 📦 Kompressor-Produkte

OP Job Tracker kann jetzt Produkte erkennen, die mit dem OPSUCHT-Kompressor erstellt wurden.

Erfasst werden:

| Produkt | Tracking |
| --- | ---: |
| Steinplatten | ✅ |
| Holzbündel | ✅ |
| Gräbergemisch | ✅ |

Gezählt werden ausschließlich tatsächlich erzeugte Produkte.

Die Erkennung wurde so aufgebaut, dass unter anderem folgende Aktionen **nicht fälschlich zählen**:

- fertiges Produkt droppen und wieder aufsammeln
- Produkt aus einer Kiste nehmen
- Produkt an einer Shopkiste kaufen
- Produkt innerhalb des Inventars verschieben
- fertiges Produkt von einem anderen Spieler erhalten

Auch Komprimierungen werden berücksichtigt, bei denen ein Teil der benötigten Rohstoffe bereits vorher im Inventar vorhanden war.

---

## 💱 Shardhändler-Tauschstatistik

Der Tausch von Gegenständen gegen OPShards kann jetzt ebenfalls ausgewertet werden.

Unterstützt werden:

| Gegenstand | Getauschte Menge | Erhaltene OPShards |
| --- | ---: | ---: |
| Steinplatten | ✅ | ✅ |
| Holzbündel | ✅ | ✅ |
| Gräbergemisch | ✅ | ✅ |
| Diamantblöcke | ✅ | ✅ |
| Netheritbarren | ✅ | ✅ |

Gespeichert werden:

- tatsächlich getauschte Menge
- tatsächlich erhaltene OPShards

---

## 🕒 Zeitraum-Auswertung

Auch die neuen Schatz- und Shardhändler-Daten nutzen das bekannte Zeitraumsystem:

- Stunde
- Tag
- Woche
- Monat
- Jahr
- Gesamt

Damit können Jobschätze, Kompressor-Produkte und Shardhandel langfristig ausgewertet und miteinander verglichen werden.

---

## 🛠️ Verbesserungen & Fehlerbehebungen

- Jobschatz-Erkennung an echte OPSUCHT-Servermeldungen angepasst
- Schutz gegen doppelte Schatz-Erfassung
- Spielerchat kann den Jobschatz-Zähler nicht fälschlich erhöhen
- Minecraft-Farbcodes werden vor der Belohnungsauswertung entfernt
- Jobschatz-Belohnungsparser verbessert
- Jobschatz-XP werden getrennt pro Job angezeigt
- Jobschatz-XP beeinflussen normale XP/h-Werte nicht
- Job-XP-Dashboard optisch verbessert
- neuer kombinierter **Schätze / Shards** Bereich
- Kompressor-Produkttracking hinzugefügt
- Erkennung bei verzögerten Inventaränderungen verbessert
- Komprimierung mit bereits vorhandenen Rohstoffen verbessert
- Schutz vor falschen Kompressor-Zählungen verbessert
- dynamisches Shardhändler-Tauschtracking hinzugefügt
- Fehler behoben, durch den erkannte Tauschaktionen in der Anzeige trotzdem `0` zeigten
- profilsichere Speicherung der Shardhändler-Daten verbessert
- responsives Dashboard weiter optimiert

---

## 🎮 Kompatibilität

OP Job Tracker 1.0.2 ist verfügbar für:

- **Minecraft 1.21.11**
- **Minecraft 26.1.x**
- **Minecraft 26.2**

### Voraussetzungen

- Fabric Loader
- Fabric API
- ausschließlich clientseitige Installation
- benötigte Java-Version abhängig von der Minecraft-Version

Eine Installation auf dem Server ist nicht erforderlich.

> OP Job Tracker ist ein unabhängiges Community-Projekt und keine offizielle Modifikation von OPSUCHT.