@slrmyapi/mlreg/README.md

API untuk semakan ID Mobile Legends

# 🎯 MLREG API - @slrmyapi/mlreg

Pakej MLREG API membolehkan anda menyemak ID Mobile Legends (MLBB) dan mendapatkan maklumat lengkap seperti nickname, negara, mata wang & bahasa rasmi dengan mudah.

---

# 📦 Pemasangan

> npm install @slrmyapi/mlreg

---

# 📥 Cara Penggunaan

```javascript
const { getmlreg } = require("@slrmyapi/mlreg");

// Contoh: Semak ID MLBB dengan User ID & Zone ID
getmlreg("634941640", "8524").then(console.log);

/*
Output:
{
  "status": "success",
  "mlreg_data": {
    "user_id": "634941640",
    "server_id": "8524",
    "nickname": "Univ+Anuu.",
    "country_code": "MY",
    "status": "invalid",
    "icon": "success"
  },
  "country_data": {
    "nama": "Malaysia",
    "penduduk": 33600000,
    "emoji": "🇲🇾",
    "kod_telefon": "+60",
    "mata_wang": {
      "kod": "MYR",
      "simbol": "RM",
      "nama": "Ringgit Malaysia"
    },
    "nombor_cukai": {
      "jenis": "Nombor Pengenalan Cukai",
      "nama_rasmi": "Nombor Pengenalan Cukai Malaysia (TIN)"
    },
    "bahasa_rasmi": {
      "kod": "ms",
      "nama_melayu": "Melayu",
      "nama_asal": "Bahasa Melayu"
    },
    "rantau": "Asia Tenggara",
    "global_selatan": true
  },
  "devInfo": {
    "GitHub": "https://github.com/slrmyshopofficial",
    "NPM": "@slrmyapi",
    "WhatsApp": "+601136871190",
    "Instagram": "@slrmyshopofficial"
  }
}
*/
```
---

# 📌 Contoh Kod

```javascript
const { getmlreg } = require("@slrmyapi/mlreg");

async function getmlreg(userId, zoneId) {
    try {
        const result = await getmlreg(userId, zoneId);
        if (result.status !== "success") {
            console.log("⚠️ Error:", result.message);
        } else {
            console.log("✅ Keputusan:", result);
        }
    } catch (error) {
        console.error("❌ API Bermasalah:", error);
    }
}

// Contoh penggunaan:
getmlreg("634941640", "8524");
```

---

# 📊 Penerangan Data dalam Respons API

| **Nama Kunci**    | **Penerangan** |
|------------------|---------------|
| `status` | Status permintaan API (success/error). |
| `mlreg_data.user_id` | ID Pengguna Mobile Legends. |
| `mlreg_data.server_id` | ID Server Mobile Legends. |
| `mlreg_data.nickname` | Nama pengguna dalam permainan. |
| `mlreg_data.country_code` | Kod negara pengguna berdasarkan MLBB. |
| `mlreg_data.status` | Status ID MLBB sama ada sah atau tidak. |
| `mlreg_data.icon` | Ikon status permintaan. |
| `country_data.nama` | Nama negara pengguna berdasarkan kod negara MLBB. |
| `country_data.penduduk` | Jumlah penduduk negara tersebut. |
| `country_data.emoji` | Bendera emoji negara pengguna. |
| `country_data.kod_telefon` | Kod telefon antarabangsa negara pengguna. |
| `country_data.mata_wang.kod` | Kod mata wang rasmi negara. |
| `country_data.mata_wang.simbol` | Simbol mata wang rasmi. |
| `country_data.mata_wang.nama` | Nama mata wang penuh. |
| `country_data.nombor_cukai.jenis` | Jenis nombor pengenalan cukai negara. |
| `country_data.nombor_cukai.nama_rasmi` | Nama rasmi nombor cukai negara. |
| `country_data.bahasa_rasmi.kod` | Kod bahasa rasmi negara. |
| `country_data.bahasa_rasmi.nama_melayu` | Nama bahasa dalam bahasa Melayu. |
| `country_data.bahasa_rasmi.nama_asal` | Nama asal bahasa dalam skrip asal. |
| `country_data.rantau` | Rantau atau kawasan geografi negara. |
| `country_data.global_selatan` | Status sama ada negara tergolong dalam Global Selatan. |
| `devInfo.GitHub` | Pautan GitHub pembangun API. |
| `devInfo.NPM` | Pakej NPM API ini. |
| `devInfo.WhatsApp` | Nombor WhatsApp pemaju API. |
| `devInfo.Instagram` | Akaun Instagram pemaju API. |

---

# 📌 Ciri-ciri Pakej

- ✅ Tunjukkan maklumat negara, mata wang, bahasa rasmi dalam respons
- ✅ Mudah digunakan dalam bot WhatsApp, website, atau sistem automasi

---

# 👨‍💻 Developer Info

<p align="left">
  <a href="https://github.com/slrmyshopofficial">
    <img src="https://img.shields.io/badge/GitHub-000000?style=for-the-badge&logo=github&logoColor=white" alt="GitHub">
  </a>
  <a href="https://www.npmjs.com/package/@slrmyapi/">
    <img src="https://img.shields.io/badge/NPM-CB3837?style=for-the-badge&logo=npm&logoColor=white" alt="NPM">
  </a>
  <a href="https://wa.me/601136871190">
    <img src="https://img.shields.io/badge/WhatsApp-25D366?style=for-the-badge&logo=whatsapp&logoColor=white" alt="WhatsApp">
  </a>
  <a href="https://instagram.com/slrmyshopofficial">
    <img src="https://img.shields.io/badge/Instagram-E4405F?style=for-the-badge&logo=instagram&logoColor=white" alt="Instagram">
  </a>
</p>
---