Hướng dẫn

Cách cài plugin Minecraft

Cập nhật 18 tháng 10, 2026

Cài một plugin chỉ mất một phút: bạn thả tệp .jar vào thư mục plugins/ của máy chủ rồi khởi động lại. Hầu hết vấn đề đến từ những bước xung quanh: máy chủ không chạy được plugin, plugin làm cho phiên bản khác, hoặc thiếu một dependency. Hướng dẫn này nói về tất cả những điều đó.

Thử trên máy chủ thử nghiệm trước, rồi cài tệp .jar.

Tạo thứ này với Codexe

Từng bước

  1. 1.Kiểm tra máy chủ có chạy được plugin không

    Plugin cần phần mềm máy chủ dựa trên Bukkit: Paper, Spigot, Purpur hoặc Folia cho máy chủ game, BungeeCord hoặc Velocity cho proxy. Máy chủ vanilla, hay máy chủ Fabric hoặc Forge, không nạp plugin.

  2. 2.Kiểm tra phiên bản của plugin

    Trang hoặc tệp của plugin ghi rõ nó hỗ trợ những phiên bản Minecraft nào. Plugin build cho phiên bản mới hơn máy chủ của bạn thường sẽ không chịu nạp.

  3. 3.Dừng máy chủ và chép tệp .jar

    Đặt tệp .jar vào thư mục plugins/ nằm cạnh tệp .jar của máy chủ. Trên bảng điều khiển hosting, tải lên bằng trình quản lý tệp hoặc SFTP. Đừng giải nén nó.

  4. 4.Cài các dependency của nó

    Nếu plugin cần plugin khác (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), hãy đặt cả tệp .jar của chúng vào plugins/.

  5. 5.Khởi động máy chủ và đọc console

    Tìm tên plugin trong log khởi động. "Enabling <Plugin>" mà không có lỗi phía sau nghĩa là nó đã được nạp.

  6. 6.Kiểm tra trong game và cấu hình

    Chạy /plugins: plugin đã nạp có màu xanh lá, plugin không bật được có màu đỏ. Thiết lập của nó nằm trong plugins/<PluginName>/config.yml; sửa chúng rồi khởi động lại.

Các tệp nằm ở đâu

Một thư mục máy chủ điển hình trông như thế này sau lần khởi động đầu tiên với một plugin:

  • paper.jar (hoặc spigot.jar): chính là máy chủ.
  • plugins/MyPlugin.jar: plugin bạn đã thêm.
  • plugins/MyPlugin/: thư mục do plugin tạo ra, chứa config.yml, tin nhắn và dữ liệu đã lưu.
  • logs/latest.log: log của lần chạy hiện tại, nơi ghi các lỗi khi nạp.

Khởi động lại, đừng /reload

/reload gỡ và nạp lại mọi plugin mà không khởi động lại máy chủ. Nhiều plugin không hỗ trợ việc này: listener bị đăng ký hai lần, dữ liệu bị mất hoặc rò rỉ bộ nhớ. Luôn khởi động lại máy chủ sau khi thêm, gỡ hoặc cập nhật một plugin. Một số plugin có lệnh reload riêng (ví dụ /myplugin reload) chỉ cho tệp cấu hình của chúng: lệnh đó thì dùng an toàn.

Trước khi cài lên máy chủ đang chạy thật

  • Sao lưu thư mục máy chủ, hoặc ít nhất là plugins/ và các thế giới.
  • Thử trên một bản sao trước: cùng phần mềm, phiên bản và các plugin khác như máy chủ thật. Xem cách thử nghiệm plugin.
  • Mỗi lần một plugin: nếu có gì hỏng, bạn biết plugin nào gây ra.
  • Tải từ trang của tác giả (SpigotMC, Hangar, Modrinth, GitHub), không tải từ các bản đăng lại.

Plugin làm bằng Codexe

Plugin làm trên Codexe đến tay bạn dưới dạng tệp .jar đã build, đặt tên theo dự án, và được kiểm tra trước khi bạn nhận: nó phải chứa các lớp đã biên dịch và một plugin.yml. Bạn có thể thử trên một máy chủ thử nghiệm riêng trước khi cài ở bất cứ đâu, miễn phí ở mọi gói; máy chủ thử nghiệm tự cài các plugin được ghi là dependency. Tải tệp .jar cho máy chủ của riêng bạn cần một gói hoặc một gói lượt tải.

Câu hỏi

Tôi có thể cài plugin lên máy chủ vanilla không?

Không. Hãy thay tệp .jar của máy chủ bằng Paper (hoặc Spigot) cùng phiên bản Minecraft; thế giới của bạn vẫn hoạt động bình thường. Với máy chủ vanilla, datapack là giải pháp thay thế.

Tôi có thể cài plugin khi chơi đơn không?

Không, plugin chỉ chạy trên máy chủ. Bạn có thể chạy một máy chủ Paper cục bộ trên máy tính của mình và vào nó qua localhost.

Người chơi có cần cài gì không?

Không. Plugin chỉ chạy trên máy chủ: người chơi vào bằng game bình thường. Chỉ những plugin dùng resource pack mới yêu cầu người chơi chấp nhận pack.

Vì sao plugin của tôi có màu đỏ trong /plugins?

Plugin đã được tìm thấy nhưng không bật được. Lý do nằm trong console ngay phía trước: xem cách sửa lỗi plugin.

Làm một plugin bạn có thể cài ngay hôm nay

Prompt này mở ra sẵn sàng để gửi:

“Một plugin Paper 1.21.4 tên JoinMessages: tin nhắn vào và thoát tùy chỉnh với tên người chơi và số người online, tin nhắn khác cho lần vào đầu tiên, một tiêu đề chào mừng, và mọi tin nhắn cùng âm thanh trong config.yml.”

Tạo thứ này với Codexe
Cách cài plugin Minecraft lên máy chủ của bạn | Codexe