> For the complete documentation index, see [llms.txt](https://minecraft.card2k.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://minecraft.card2k.com/chuc-nang/tong-hop-cac-chuc-nang/nap-the-cao.md).

# Nạp thẻ cào

{% hint style="success" %}
Dự án hiện được phát hành miễn phí, có sự hỗ trợ từ [Nexus Studio](https://dsc.gg/nexusstudio). Và chịu trách nhiệm bởi đơn vị [Card2K](http://card2k.com/)
{% endhint %}

> **Lệnh sử dụng**: `/napthe gui`

<figure><img src="/files/NqroFdCNgahCYuni4wR4" alt=""><figcaption><p>Giao diện chọn nhà mạng</p></figcaption></figure>

<figure><img src="/files/otzrdBxTkMVcXcgUa4va" alt=""><figcaption><p>Giao diện chọn mệnh giá</p></figcaption></figure>

<figure><img src="/files/e7JlkPXVRS7cNcjzVuXT" alt=""><figcaption><p>Nhập mã thẻ &#x26; serial trên kênh chat</p></figcaption></figure>

> Lệnh nạp trên kênh chat `/napthe <nhà mạng> <mệnh giá> <serial> <mã thẻ>`

<figure><img src="/files/GZjnCMXz365yh5uVJ5Fd" alt=""><figcaption><p>Lệnh nạp thẻ trên kênh chat</p></figcaption></figure>

File cấu hình nạp thẻ `config.yml`&#x20;

> **Mốc nạp**

```yaml
mocnap:
  enabled: true
  # Cau hinh thuong theo moc nap (so tien tich luy)
  # Su dung %player% de thay the ten nguoi choi
  milestones:
    10000:
      - "give %player% diamond 1"
      - "eco give %player% 10000"
    20000:
      - "give %player% diamond 2"
      - "eco give %player% 20000"
  ...
```

> **Khuyến mãi**: nhân 2, nhân 3,.. vào các dịp sự kiện (nếu muốn)

```yml
# He so nhan thuong (phai >= 1)
# Neu dat la 2, tat ca cac lenh thuong se duoc thuc thi 2 lan
# Vi du: reward_multiplier: 2 va thuong la "give %player% diamond 1"
#        -> Nguoi choi se nhan 2 diamond (lenh chay 2 lan)
reward_multiplier: 1
```

> **Xử lý ngoại lệ đối với thẻ sai mệnh giá:**
>
> 1. Trao thưởng khi sai mệnh giá.
> 2. Không trao thưởng khi sai mệnh giá.

```yaml
# Khong thuong khi nap sai menh gia
# true: Khong thuong khi nguoi choi khai bao sai menh gia (status = 2)
# false: Van thuong dua tren gia tri thuc cua the (mac dinh)
# Luu y: Khi bat tinh nang nay, nguoi choi van nhan thong bao thanh cong
#        nhung khong nhan thuong, khong tinh vao moc nap, khong ghi nhan thong ke
no_reward_on_wrong_amount: false
```

> **Thông báo discord** khi có giao dịch

```yml
# ============================================
# Discord Webhook Configuration
# Gui thong bao den Discord khi co giao dich the
# ============================================
discord:
  enabled: false
  webhook_url: ""
  bot_name: "Card2K"
  avatar_url: ""
  # Mau sac embed cho tung trang thai (dang hex khong co #)
  colors:
    pending: "FFA500"    
    success: "00FF00"    
    wrong_amount: "FFFF00"  
    failed: "FF0000"    

  # Tieu de embed cho tung trang thai
  titles:
    pending: "🔄 Thẻ đang được xử lý"
    success: "✅ Nạp thẻ thành công"
    wrong_amount: "⚠️ Nạp thẻ thành công (sai mệnh giá)"
    failed: "❌ Nạp thẻ thất bại"

  # Hien thi thong tin trong embed
  # Cac placeholder: %player%, %uuid%, %telco%, %amount%, %actual_amount%,
  #                  %serial_masked%, %request_id%, %trans_id%, %status%, %message%
  fields:
    player: "Người chơi"
    uuid: "UUID"
    telco: "Nhà mạng"
    declared_amount: "Mệnh giá khai báo"
    actual_amount: "Giá trị thực"
    serial: "Serial"
    request_id: "Request ID"
    trans_id: "Transaction ID"
    status: "Trạng thái"
    message: "Thông báo"

  footer: "Card2K - Hệ thống nạp thẻ tự động"

  show_timestamp: true

  # So ky tu cuoi cua serial duoc hien thi (de bao mat)
  # Vi du: serial_visible_chars: 4 -> Serial: ****1234
  serial_visible_chars: 4

```

> Cấu hình thẻ cào & mệnh giá

```yml
# Cau hinh nha mang va menh gia the
# enabled: true/false - Bat/tat nha mang
# amounts: Danh sach menh gia ho tro cho nha mang do
availability:
  VIETTEL:
    enabled: true
    amounts: [10000, 20000, 30000, 50000, 100000, 200000, 300000, 500000, 1000000]
  VINAPHONE:
    enabled: true
    amounts: [10000, 20000, 30000, 50000, 100000, 200000, 300000, 500000]
  MOBIFONE:
    enabled: true
    amounts: [10000, 20000, 30000, 50000, 100000, 200000, 300000, 500000]
  GARENA:
    enabled: true
    amounts: [20000, 50000, 100000, 200000, 500000]
  ZING:
    enabled: true
    amounts: [10000, 20000, 50000, 100000, 200000, 500000, 1000000]
  VCOIN:
    enabled: true
    amounts: [10000, 20000, 50000, 100000, 200000, 500000, 1000000]
```

> Môi trường ão để test hệ thống nạp hoặc fake dữ liệu.

```yml
# Che do sandbox (moi truong thu nghiem)
# true: Su dung https://sandbox.card2k.com (de test)
# false: Su dung https://card2k.com (moi truong that)
sandbox: true
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://minecraft.card2k.com/chuc-nang/tong-hop-cac-chuc-nang/nap-the-cao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.