> For the complete documentation index, see [llms.txt](https://onic-studio.gitbook.io/solarplugins-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://onic-studio.gitbook.io/solarplugins-docs/plugins/solarshards/cau-hinh.md).

# Cấu hình

#### `config.yml`

Tệp cấu hình chính quản lý cơ sở dữ liệu, giới hạn số dư và định dạng.

```yaml
# Phiên bản cấu hình hệ thống
config-version: 1.1

# Bật hiển thị nhật ký gỡ lỗi (debug) trong console
enable-debug: false

# Tùy chỉnh lưu trữ (Storage Configuration)
database:
  # Loại lưu trữ: SQLITE (cục bộ) hoặc MYSQL (mạng máy chủ)
  type: "SQLITE"
  
  # Cấu hình SQLite
  sqlite:
    file: "solar_shards.db"
  
  # Cấu hình MySQL
  mysql:
    host: "localhost"
    port: 3306
    database: "solarshards"
    username: "root"
    password: ""
    ssl: false

# Số lượng shards tối đa một người chơi có thể sở hữu. Đặt -1 để không giới hạn.
max-shards: 999999999

# Tùy chỉnh hiển thị tin nhắn
messages:
  action-bar-messages: true
  chat-messages: true
  use-action-bar-only: false
```

#### `messages.yml`

Tệp quản lý tin nhắn và ngôn ngữ. Hỗ trợ đầy đủ định dạng mã màu cũ (`&a`, `&l`) và mã màu Hex dạng `<#HEX>`.

```yaml
prefix: "&e[SolarShards] "
no-permission: "&cBạn không có quyền sử dụng lệnh này."
player-only: "&cLệnh này chỉ dành cho người chơi."
balance-message: "&aSố dư hiện tại của bạn: &e{balance} &aShards."
reload-success: "&aĐã tải lại cấu hình plugin thành công."
invalid-amount: "&cSố lượng không hợp lệ. Vui lòng nhập một số dương."
player-not-found: "&cKhông tìm thấy người chơi này hoặc người chơi không trực tuyến."
give-success: "&aĐã tặng &e{amount} &ashards cho &e{player}&a."
take-success: "&aĐã lấy &e{amount} &ashards từ &e{player}&a."
reset-success: "&aĐã đặt lại shards của &e{player} &avề 0."
reset-all-success: "&aĐã đặt lại shards của &e{count} &angười chơi về 0."
give-all-success: "&aĐã tặng &e{amount} &ashards cho &e{count} &angười chơi trực tuyến."
give-all-maxed: "&e{count} &angười chơi trực tuyến không thể nhận thêm do đạt giới hạn shards tối đa."
take-all-success: "&aĐã lấy &e{amount} &ashards từ &e{count} &angười chơi trực tuyến."
target-max-shards-reached: "&e{player} &cđã đạt giới hạn shards tối đa."
max-shards-reached: "&cBạn đã đạt giới hạn shards tối đa ({max})."
target-insufficient-shards: "&e{player} &ckhông có đủ shards để trừ."
insufficient-shards: "&cBạn không có đủ shards."
usage: "&cCách dùng: /{label} [give/take/reset/reload] [player/*] [amount]"
```