Plugin Minecraft MarriageMaster

🔌 Giới thiệu về Marriage Master

Marriage Master là một plugin Bukkit/Spigot cho Minecraft, cung cấp hệ thống hôn nhân có thể cấu hình cho server. Nó cho phép người chơi kết hôn (một hoặc nhiều, nếu được cấu hình) và trao cho người chơi đã kết hôn các tính năng cùng lệnh hợp tác. Dự án bao gồm một API cho nhà phát triển và hỗ trợ lưu trữ bền vững.

🎯 Mục đích

Plugin này được thiết kế cho các server roleplay và xã hội muốn có cơ chế hôn nhân trong game: để cung cấp cho các cặp đôi tiện ích dùng chung, chat riêng, tương tác kinh tế tùy chọn, và các hiệu ứng gameplay có thể cấu hình khi hai người ở gần nhau.

⚙️ Tính năng

• Yêu cầu kết hôn giữa người chơi và lễ cưới do linh mục chủ trì (tùy chọn).
• Dịch chuyển đến bạn đời (teleport to partner) và một ngôi nhà chung mà cả hai có thể dịch chuyển đến.
• Chat riêng cho cặp đôi và một công tắc để chuyển toàn bộ chat sang cho bạn đời thay vì chat công khai.
• Vật phẩm quà tặng: người chơi có thể đưa vật phẩm đang cầm trên tay cho bạn đời.
• Công tắc PvP giữa hai người (bật/tắt PvP với bạn đời của bạn).
• Các hành động trang trí như kiss với hiệu ứng hạt.
• Thưởng XP và hồi phục khi bạn đời ở gần (có nhắc đến tích hợp cho Minecraft XP, mcMMO, SkillAPI).
• Tùy chọn backpack dùng chung / tích hợp Minepacks.
• Hỗ trợ đa ngôn ngữ thông qua các file ngôn ngữ có thể cấu hình.
• Backend lưu trữ có thể cấu hình: hỗ trợ SQLite và MySQL.
• API cho nhà phát triển plugin để tương tác với dữ liệu và sự kiện của Marriage Master.

🧩 Dành cho ai

• Các server roleplay và xã hội muốn có cơ chế quan hệ trong game.
• Các server SMP hoặc survival muốn có thêm lợi ích hợp tác tùy chọn cho từng cặp người chơi.
• Quản trị viên server cần quyền hạn và tích hợp có thể cấu hình với economy hoặc các plugin khác.

🏗️ Ví dụ sử dụng

• Hai người chơi gửi yêu cầu kết hôn và nhận được một ngôi nhà chung cùng kênh chat riêng.
• Một server bật lễ cưới do linh mục chủ trì cho sự kiện và cấp vật phẩm hoặc danh hiệu đặc biệt khi kết hôn thông qua server scripting hoặc API hooks.
• Các cặp đôi dùng lệnh gift để trao đổi vật phẩm đang cầm trên tay như một phần của roleplay.

⌨️ Lệnh

Lưu ý: các nguồn chính thức có liệt kê những lệnh này nhưng không ghi các permission node ngay trên trang resource; quyền hạn có trong tài liệu plugin và danh sách permission.

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR của plugin từ trang resource chính thức và đặt JAR vào thư mục plugins/ của server.
• Khởi động lại server và kiểm tra đầu ra console để xác nhận plugin đã tải thành công.

📦 Phụ thuộc

• Yêu cầu Java 8 khi chạy.
• Nền tảng runtime đã xác nhận: Bukkit, Spigot, Paper.
• Các tích hợp/phụ thuộc tùy chọn được tác giả ghi nhận: Vault (tùy chọn, cho tính năng economy), PCGF PluginLib (tùy chọn), tích hợp Minepacks, hỗ trợ Placeholder.
• Hỗ trợ proxy tùy chọn: BungeeCord / Waterfall.

🧾 Cấu hình

• Plugin cung cấp cấu hình đầy đủ, có tài liệu, cùng các file ngôn ngữ cho phép tùy chỉnh gần như mọi hành vi, tin nhắn và tính năng.
• Có thể cấu hình lưu trữ để dùng SQLite hoặc MySQL.

🧠 Ghi chú kỹ thuật

• Phần mềm server được hỗ trợ: Bukkit, Spigot, Paper (tác giả cho biết hỗ trợ Bukkit/Spigot/Paper và hỗ trợ proxy BungeeCord/Waterfall tùy chọn).
• Yêu cầu Java 8 khi chạy.
• Dự án có API cho nhà phát triển và cung cấp tài liệu JavaDoc cho việc tích hợp.
• Plugin hỗ trợ thay đổi UUID/tên và có hỗ trợ đa ngôn ngữ qua các file resource.

🤝 Khi nào plugin này hữu ích

Nếu bạn vận hành một server roleplay, xã hội hoặc SMP và muốn có hệ thống hôn nhân trong game với các đặc quyền có thể cấu hình, tiện ích riêng cho cặp đôi, và hooks cho nhà phát triển, Marriage Master cung cấp những tính năng đó cùng hỗ trợ cơ sở dữ liệu và tích hợp cho các hệ sinh thái server phổ biến.