Skip to content
Hosting · Cấu hình máy chủ

ops.json, banned-players.json và các danh sách khác

Các file JSON dịch vụ của máy chủ: operator, ban, whitelist và bộ nhớ đệm nickname — chúng chứa gì và khi nào được chỉnh sửa thủ công.

Cập nhật 13 tháng 8, 2026

Máy chủ lưu danh sách người chơi trong các tệp JSON ở thư mục gốc. Thông thường chúng được quản lý bằng lệnh, nhưng đôi khi mở tệp sẽ nhanh hơn.

TệpNội dung
ops.jsonOperator, cấp quyền truy cập, bypassesPlayerLimit
whitelist.jsonDanh sách trắng
banned-players.jsonCấm theo nickname và UUID
banned-ips.jsonCấm theo IP
usercache.jsonBộ nhớ đệm ánh xạ nickname → UUID

Ví dụ ops.json

[
  {
    "uuid": "8a1b...",
    "name": "Steve",
    "level": 4,
    "bypassesPlayerLimit": true
  }
]

Quy tắc chỉnh sửa

  • Chỉ khi máy chủ đã dừng. Máy chủ đang chạy giữ danh sách trong bộ nhớ và sẽ ghi đè tệp khi tắt — các chỉnh sửa của bạn sẽ bị mất.
  • Định dạng rất nghiêm ngặt: một dấu phẩy thừa sẽ làm hỏng toàn bộ tệp, và máy chủ sẽ khởi động với danh sách operator trống.
  • UUID phải khớp với nickname. Trên máy chủ premium, UUID là cố định; trên máy chủ đăng nhập bằng nickname, nó được tính từ nickname — khi bạn thay đổi online-mode, tất cả danh sách thực tế sẽ không còn khớp.

Thay đổi online-mode

Đây là nguyên nhân phổ biến nhất của việc “tất cả operator và claim biến mất”: UUID của người chơi thay đổi, và các mục cũ không còn trỏ đến ai nữa. Để biết chi tiết, xem Đăng nhập bằng nickname.

Plugin

Các plugin quyền và cấm lưu dữ liệu riêng (tệp hoặc MySQL) và bỏ qua danh sách vanilla — LuckPerms, Cấm và mute.

Hosting MinecraftMáy chủ của bạn chạy khi bạn offlineTạo máy chủ