You've already forked Epicnabbo-Catalogus-Updated-Daily
Remco
69 lines
4.0 KiB
Markdown
69 lines
4.0 KiB
Markdown
# EpicNabbo Catalogue v2 (In Development 🛠️)
|
|
|
|
EpicNabbo Catalogue v2 is a heavily optimized evolution of our catalog system, specifically engineered for **Nitro v3** with 100% full native support.
|
|
|
|
Version 1 failed to meet our strict quality standards due to a flawed initial approach. Instead of starting completely from scratch, Version 2 takes a **rock-solid base structure**, merges it with the assets from v1, and completely overhauls the framework. We are massively expanding the database to include **over 52,000+ items/furni**—a massive leap from v1, which would have only featured 31,000 items at full completion.
|
|
|
|
> ⚠️ **Current Status: Active Development (WIP)**
|
|
> The core base and v1 data merge are completed, but it is **not yet suitable for production use**. Estimated time to final release is **a few weeks**.
|
|
|
|
## 🚀 Key Improvements & Objectives over v1
|
|
|
|
* **Massive 52k+ Furni Database:** An increase of over 21,000 items compared to the 31k target of v1, optimized to handle the massive load without lag.
|
|
* **Native Nitro v3 Support:** Specially tailored to fully support all Nitro v3 features, packet structures, and UI elements.
|
|
* **Meeting High Quality Standards:** Re-engineered to fix the structural and performance flaws that caused v1 to fail our internal benchmarks.
|
|
* **100% Complete Layout:** Merging v1 data into a superior base ensures all pages, tabs, and sub-items are present with absolutely zero missing pages.
|
|
* **Efficient Development:** Combining a strong existing base with our corrected approach allows us to deliver a massive upgrade in just a fraction of the time.
|
|
|
|
## 📈 Comparison
|
|
|
|
|
|
| Feature | Version 1 (Old) | Version 2 (New) |
|
|
| :--- | :--- | :--- |
|
|
| **Status** | Discontinued (Failed Quality Checks) | **In Development (Base & Merge Ready)** 🛠️ |
|
|
| **Catalog Size (Full)** | ~31,000 Items (Projected) | **52,000+ Items (Massive Expansion)** 📦 |
|
|
| **Nitro v3 Support**| None / Partial | **100% Full Native Support** |
|
|
| **Completeness** | Missing pages & broken links | 100% Complete & verified structure |
|
|
| **Performance** | Slow loading / poor queries | Blazing fast optimized index |
|
|
| **ETA** | - | **A few weeks** |
|
|
|
|
## ⚙️ Technical Requirements & Optimization
|
|
|
|
To ensure smooth operation of the 52k+ item database, your environment must meet the following criteria:
|
|
|
|
* **Database:** MySQL 8.0+ or MariaDB 10.5+ (Required for advanced indexing optimizations).
|
|
* **Server Environment:** Fully optimized for **Nitro v3** asset structures and packet handling.
|
|
* **MySQL Configuration:** You **must** increase your packet size limits in your `my.ini` or `my.cnf` file before importing the SQL file due to its massive size, otherwise the import will crash:
|
|
```ini
|
|
max_allowed_packet = 64M
|
|
```
|
|
|
|
## 📁 Repository Structure
|
|
|
|
```text
|
|
├── .gitlab/ # CI/CD and issue templates
|
|
├── database/ # Optimized SQL structures (Base + v1 Merge + 52k Expansion)
|
|
│ ├── core_catalog.sql # The main catalog table structures
|
|
│ └── items_dump.sql # Full 52,000+ items dataset
|
|
├── nitro_assets/ # Nitro v3 configuration files and JSON hooks
|
|
└── README.md
|
|
```
|
|
|
|
## 🛠️ Current Roadmap
|
|
|
|
- [x] Analyze v1 bottlenecks and establish a superior base framework.
|
|
- [x] Merge v1 catalog data into the new clean database structure.
|
|
- [/] Expand and index the database to support 52,000+ items (In Progress).
|
|
- [/] Integrate full Nitro v3 compatibility hooks (In Progress).
|
|
- [ ] Final quality assurance testing and zero-missing-pages validation.
|
|
|
|
## 📦 Database Installation Guide (Development Preview)
|
|
|
|
1. Clone this repository to your local machine:
|
|
```bash
|
|
git clone gitlab.com
|
|
```
|
|
2. Open your MySQL terminal or database tool (e.g., Navicat, HeidiSQL).
|
|
3. Import `core_catalog.sql` first to set up the clean page structures.
|
|
4. Import `items_dump.sql` to populate the 52,000+ items. *(Note: This may take a few minutes depending on your hardware).*
|
|
5. Clear your Nitro v3 server cache and restart your emulator environment. |