✦ OmniCraft
MarkdownEN
PAPER RPG CRAFTING

Chế tạo RPG rõ ràng, nhanh và an toàn.

Recipe Vanilla và MMOItems, batch crafting, craft time, giới hạn, Vault, PlaceholderAPI và giao dịch phía server ưu tiên chống dupe.

Paper 1.20–1.21.11JAR legacy · Java 21
Paper 26.1+JAR 26 · Java 25
Soft dependenciesMMOItems, Vault, PAPI, AE, AuraSkills

Bắt đầu trong 5 phút

  1. Cài đúng JAR cho phiên bản server và khởi động một lần.
  2. Mở plugins/OmniCraft/config.yml, sau đó tạo recipe tại category/<id>/.
  3. Chạy /oc validate để kiểm tra recipe.
  4. Chạy /oc reload sau khi chỉnh file.
MMOItems, Vault, PlaceholderAPI và AdvancedEnchantments là tùy chọn. Thiếu hook không ngăn plugin khởi động; recipe cần hook đó sẽ bị từ chối an toàn.

Hướng dẫn người chơi

Mở và chọn recipe

Dùng /oc, chọn category và recipe. Menu có lọc recipe craft được, favorites và tìm kiếm.

Thao tác craft

Chuột trái: số lượng thường. Chuột phải: batch. Shift: tối đa theo inventory và hard-cap.

Craft có thời gian

Fast Craft nhận modifier theo permission hoặc PlaceholderAPI. Điều kiện được kiểm tra lại trước khi tiêu nguyên liệu.

Giới hạn

Recipe có thể giới hạn ngày/tuần; quota được reserve và trả lại khi giao dịch rollback.

Quản trị và lệnh

LệnhQuyềnMục đích
/ocomnicraft.useMở menu.
/oc open <category>category hoặc open.<id>Mở category trực tiếp.
/oc browseomnicraft.adminTạo và sửa recipe bằng GUI.
/oc validateomnicraft.validateKiểm tra config/recipe.
/oc debug recipe <id>omnicraft.debugDry-run, không tiêu nguyên liệu.
/oc autocraft <recipe> [amount]omnicraft.auto-craftChạy queue AutoCraft online.
/oc autocraft-cancelomnicraft.auto-craftHủy queue hiện tại.
/oc autocraft-statusomnicraft.auto-craftXem node còn lại và trạng thái hiện tại.
/oc autocraft-resumeomnicraft.auto-craftTiếp tục queue đã dừng an toàn trước khi restart.
/oc reloadomnicraft.reloadĐọc lại file.

Recipe YAML

# Recipe mẫu: chỉ bật AutoCraft cho recipe trung gian
id: steel_sword
display:
  name: "#7cf5ffSteel Sword"
output:
  mode: VANILLA
  material: IRON_SWORD
  amount: 1
ingredients:
  iron:
    amount: 24
    item: { mode: VANILLA, material: IRON_INGOT, amount: 1 }
requirements: { level: 5, money: 250.0 }
craft-time:
  enabled: true
  seconds: 5
  quantity-scaling: LINEAR
  minimum-seconds: 1
  maximum-seconds: 3600
limits: { daily: -1, weekly: -1 }
auto-craft: { enabled: false, priority: 0 }
auraskills:
  skill: FORGING
  minimum-level: 10
  experience: 12.5
catalyst:
  amount: 1
  item: { mode: VANILLA, material: BLAZE_POWDER, amount: 1 }
station: { material: SMITHING_TABLE, radius: 3 }
outcome:
  critical: { chance: 10.0, bonus-crafts: 1 }
  byproduct:
    chance: 25.0
    item: { mode: VANILLA, material: IRON_NUGGET, amount: 2 }
  quality:
    name: Masterwork
    chance: 5.0
    lore: ["#ffd166A rare masterwork."]
AutoCraft bật mặc định (có thể tắt bằng features.auto-craft): chỉ bật auto-craft.enabled cho recipe trung gian và dùng /oc autocraft <recipe> [amount]. Queue chạy khi online, ưu tiên inventory, chặn cycle/depth và hủy khi logout/reload. Sau restart, chỉ queue đang chờ mới được người chơi tự tiếp tục qua /oc autocraft-resume; craft đang commit không bao giờ bị phát lại.

RPG progression nội bộ

Station

Block yêu cầu được kiểm tra trong bán kính station.radius quanh người chơi khi bắt đầu và trước commit. Rời trạm trong countdown hay AutoCraft sẽ fail an toàn, không tiêu node tiếp theo.

Catalyst

Catalyst là vật phẩm bị tiêu mỗi craft. Nó đi qua cùng allocation planner với ingredient, vì thế một stack không thể bị tính hai lần.

Critical

bonus-crafts thêm số lần output cho mỗi craft critical. Chance được clamp 0–100 và kết quả có seed trong audit log.

Byproduct

Byproduct là output phụ có chance theo từng craft. OmniCraft reserve trước sức chứa cho kết quả lớn nhất; đầy inventory sẽ hủy nguyên giao dịch.

Quality

Quality tạo output có metadata/lore tier riêng theo chance. Mỗi roll dùng seed trong audit log. Quality không tương thích với AE KEEP, để không làm mất metadata enchant đã giữ.

Tích hợp

MMOItems / MythicLib

Dùng mode: MMOITEMS với type và id. Không resolve được output sẽ fail an toàn, không rơi về item Vanilla.

Vault / PlaceholderAPI

Vault xử lý tiền; PlaceholderAPI dùng điều kiện và speed multiplier. Giá trị speed bất thường được clamp.

AdvancedEnchantments

Chế độ KEEP, DESTROY hoặc EXTRACT cho enchant trên nguyên liệu nâng cấp.

AuraSkills

Soft-depend: recipe có thể yêu cầu level một skill mặc định và thưởng XP sau craft đã commit. Thiếu AuraSkills chỉ chặn recipe dùng block auraskills, không ảnh hưởng craft cơ bản.

An toàn chống dupe

  • Phân bổ ingredient không dùng trùng slot inventory.
  • Revalidate item, số lượng, key và risk ngay trước mutation.
  • Thiếu chỗ output sẽ hoàn inventory snapshot và refund tiền.
  • Mỗi người chơi chỉ có một craft job; thời gian dùng monotonic clock.
  • Refund Vault lỗi được lưu bền vững và thử lại khi người chơi online.

Khắc phục lỗi

Recipe không craftChạy /oc validate; kiểm tra permission, level, tiền, hook và nguyên liệu.
MMOItems thiếu itemKiểm tra type/id, reload MMOItems rồi /oc reload.
Inventory đầyGiải phóng chỗ; OmniCraft hủy giao dịch an toàn thay vì drop/dupe output.
AE bị mấtChọn KEEP hoặc EXTRACT cho recipe upgrade.