nicelight_memoryfix

#  Nicelight Memory Fix Deep (Forge 1.20.1)

**Nicelight Memory Fix Deep** is a runtime memory-leak mitigation and cache-cleanup utility for Minecraft Forge 1.20.1. It is designed to prevent RAM accumulation and stuttering during extended play sessions.

### 📌 What It Does
* **ThreadLocal Leak Mitigation**: Safely detaches orphaned references retained on worker threads without requiring `--add-opens`.
* **Safe Entity Brain Cleanup**: Resets expired memories and dead-target links in mob `Brain` instances to `Optional.empty()` without removing keys (**100% crash-free compatibility with Epic Fight**).
* **Chunk & Ticket Eviction**: Evicts stale `DistanceManager` tickets and unloads POI `SectionStorage` from unloaded chunks.
* **Audio & GPU Maintenance**: Terminates looping ghost sounds, reclaims unused OpenAL buffers, and trims `MapRenderer` textures.
* **Heap Pressure Automation**: Monitors RAM thresholds (50% Soft, 70% Light, 82% Strong) to run light background cleanups smoothly without freezing the game.

---

### ⌨️ All In-Game Commands (`/nm` or `/nmem`)

* `/nm stats` (or `/nm`) — Displays real-time used RAM, committed heap, and retained world status.
* `/nm sweep` — **[Full Cleanup]** Manually triggers a deep purge across all 16+ cache tiers (audio, textures, chunk tickets, threadlocals, brain memories) and outputs a detailed report.
* `/nm scan` — Runs a diagnostic scan to detect objects currently retained on background threads.
* `/nm gc` — Runs targeted cleanup and requests an immediate JVM Garbage Collection cycle.
* `/nm pressure` — Evaluates current heap pressure against configured thresholds and runs appropriate cleanup if exceeded.
* `/nm watchdog` — Reports the status of the dimension/world leak monitor (retained worlds).
* `/nm config` — Prints a summary of all active configuration parameters.
* `/nm discover` — Manually scans loaded mod jars at runtime to discover cache classes.

---

### ⚙️ Configuration
Settings can be customized in: `config/nicelight_memoryfix_deep.json`

================================================================================

# 🇻🇳 

**Nicelight Memory Fix Deep** là mod dọn dẹp cache rác và giảm rò rỉ bộ nhớ (Memory Leak) lúc đang chơi cho Minecraft Forge 1.20.1, giúp game không bị phình RAM khi chơi lâu.

### 📌 Công Dụng Chính:
* **Dọn Rác ThreadLocal:** Giải phóng các tham chiếu bị kẹt trên các luồng xử lý ngầm mà không cần cờ `--add-opens`.
* **Dọn Ký Ức AI An Toàn:** Đưa mục tiêu của quái đã chết về `Optional.empty()` để cắt liên kết rác, **tương thích 100% không bao giờ crash với Epic Fight**.
* **Xả Vé Giữ Chunk:** Hủy vé giữ chunk thừa và dữ liệu POI section của các chunk đã dỡ tải.
* **Dọn Âm Thanh & Đồ Họa:** Dập tắt âm thanh ma bị lặp, thu hồi buffer OpenAL và cắt tỉa texture bản đồ cầm tay.
* **Tự Động Theo Dõi Áp Lực RAM:** Tự động kích hoạt dọn dẹp theo các mức tải (50% / 70% / 82%) một cách êm ái, không làm khựng hình.

---

### ⌨️ Đầy Đủ Các Lệnh Trong Game (`/nm` hoặc `/nmem`)

* `/nm stats` (hoặc `/nm`) — Xem thống kê RAM thực tế đang dùng và tình trạng thế giới ngầm.
* `/nm sweep` — **[Lệnh dọn mạnh nhất]** Kích hoạt dọn dẹp toàn diện 16+ tầng cache và in báo cáo chi tiết vào khung chat.
* `/nm scan` — Quét chẩn đoán các đối tượng rác đang bị neo giữ trên các luồng.
* `/nm gc` — Dọn dẹp cache và kích hoạt Java GC thu gom rác ngay lập tức.
* `/nm pressure` — Đo áp lực RAM tức thời và kích hoạt dọn dẹp tương ứng nếu vượt ngưỡng.
* `/nm watchdog` — Báo cáo tình trạng các thế giới/dimension chưa được giải phóng.
* `/nm config` — Xem tóm tắt toàn bộ thiết lập cấu hình của mod.
* `/nm discover` — Kích hoạt quét tìm kiếm các class cache mới trong runtime.