Xử lý sự cố IAUP

Plugin disable khi startup

IAUP tự disable khi config bắt buộc invalid.

Kiểm tra console:

Invalid configuration

Bắt buộc:

• s3.bucket
• s3.access_key
• s3.secret_key
• s3.region hoặc s3.endpoint

Sửa config, rồi restart server.

/iaup upload báo thiếu pack file

IAUP kiểm tra:

global:
  output_file: "plugins/ItemsAdder/output/generated.zip"

Sửa:

/iazip

Sau đó:

/iaup upload

Nếu ItemsAdder output path khác, cập nhật global.output_file.

Upload already in progress

IAUP chỉ cho một upload cùng lúc.

Đợi upload hiện tại hoàn tất. Nếu reload hoặc plugin disable xảy ra trong upload trước đó, chạy:

/iaup reload

ItemsAdder config không được cập nhật

Kiểm tra:

global:
  update_itemsadder_config: true

Sau đó xác nhận IAUP tìm được:

plugins/ItemsAdder/config.yml

Nếu cần:

global:
  itemsadder_config_path: "plugins/ItemsAdder/config.yml"

IAUP trước tiên cố giữ file YAML hiện có bằng cách thay đúng URL line. Nếu fail, nó fallback sang Bukkit YAML writing.

Player không tải được pack

Mở URL cuối cùng từ ngoài máy server.

Kiểm tra:

• object tồn tại trong bucket
• bucket hoặc CDN cho public read, hoặc URL là presigned URL hợp lệ
• public_url_base trỏ tới domain public client-facing
• cache-bust query parameter được CDN/provider chấp nhận
• presigned URL chưa hết hạn

Cloudflare R2 upload fail

Dùng:

s3:
  region: "auto"
  path_style: true
  acl: "private"

Đặt public_url_base tới public/custom domain của R2 cho public download.

MinIO URL sai shape

Thử:

s3:
  path_style: true

Nếu player cần domain public riêng, đặt:

s3:
  public_url_base: "https://cdn.example.com"

Auto upload không chạy sau /iazip

Kiểm tra:

global:
  auto_upload_on_pack: true

Sau đó kiểm tra console có hook registration:

ItemsAdder pack hook registered.

Nếu console báo không tìm thấy ItemsAdder API event, version ItemsAdder của bạn có thể không expose event class mà IAUP lắng nghe. Dùng manual /iaup upload.

/iareload không tự chạy

Bật đúng flag:

global:
  auto_iareload_after_manual_upload: true
  auto_iareload_after_auto_upload: true

IAUP chỉ dispatch /iareload sau upload thành công và cập nhật ItemsAdder config thành công.