Documentation / Tu Tiên
Wiki chính thức v7.7.3.2
FREE Vĩnh Viễn Không Cần KeyPhiên Bản v7.7.3.2 Chính ThứcLinh Thú GUI · Ngự Kiếm 3D · Bách Nghệ

Cẩm nang Tu Tiên
cho chủ server Minecraft.

Cẩm nang toàn diện TuTien Plugin v7.7.3.2: Hệ thống Linh Thú GUI 54 ô tương tác 3 chế độ, Ngự Kiếm Phi Hành 3D 360° theo tầm nhìn, Cẩm Nang Tu Tiên GUI tra cứu lệnh in-game, Cảnh Giới, Tông Môn, Bách Nghệ, Cơ Duyên và bản FREE vĩnh viễn không cần license key.

●FREE không hết hạn●Premium Owner Hub · Skin Studio●License xác minh phía server

Tính năng chính

Chọn edition phù hợp với nhu cầu. Các chức năng tùy thuộc bản plugin, hook tương thích và cấu hình của server.

☯

Hệ thống tu tiên

Nền tảng gameplay tu tiên và các hệ thống đi kèm trong plugin.

Có ở FREE & PREMIUM
✦

Skill Skin Studio

Mapping effect key với ItemsAdder entity, xem trước và lưu cấu hình riêng.

Premium
⌘

License theo host

Xác minh key, installation và host binding bằng API phía server.

FREE & PREMIUM
⇄

Hook tương thích

Kết nối các plugin phụ thuộc đã được hỗ trợ và bật trong cấu hình.

▤

Cấu hình có thể xuất

Premium Owner Hub hỗ trợ chỉnh, lưu và tải 17 file YAML mô-đun theo license cho chủ server.

♧

Tài khoản Portal

Tự nhận key FREE vĩnh viễn hoặc liên kết key Premium Owner cung cấp.

Tu Tiên v7.9.1.2 Feature Tour
✦ THẦN KHÍ V7.9.1.2 · CHIẾN ĐẤU TỰ ĐỘNG

Khí Linh Thần Thú
Thanh Long Xuất Thể

Hệ thống Linh Thú AI tự động: tầm quét mục tiêu 12 khối, phản kích chớp nhoáng bảo vệ chủ nhân khi bị sát thương, phóng thiên lôi uy lực và tăng trưởng theo 4 giai đoạn tu vi.

⚡ Quét mục tiêu 12 khối 🛡 Phản kích tự động 🐉 4 Giai đoạn tiến hóa 📜 GUI 54 ô 1-Click
🐉
THANH LONG KHÍ LINH
Giai đoạn 4: Thần Thú Tột Đỉnh
✧ BÁCH NGHỆ CƠ DUYÊN · TRẬN BÀN THỰC CHIẾN

Tụ Linh Trận Mâm
Trận Pháp Hộ Thể 16 Khối

Đặt trận bàn trực tiếp trên mặt đất: tạo luồng xoáy linh khí gom năng lượng trời đất, tăng 300% tốc độ tu luyện, tạo màn chắn hộ thể đẩy lùi ma thú và hồi phục chân nguyên cho toàn đội.

☯ Bán kính 16 blocks ▲ +300% Tốc độ tu vi 🛡 Khiên chắn ma thú ⭐ Cửu Cung Trận Nhãn
☯
TỤ LINH BÁT QUÁI TRẬN
Linh Khí Thiên Địa Quy Tụ
◈ HÓA THẦN THIÊN ĐỊA · ĐỈNH CAO TU TIÊN

Cự Linh Pháp Tướng
Thiên Địa Đồng Thọ

Đột phá Hóa Thần Kỳ, ngưng tụ Cự Linh Pháp Thân uy nghiêm cao 10 blocks phía sau lưng. Tăng 500% sát thương chí mạng, miễn nhiễm mọi hiệu ứng khống chế, lôi kiếp và trảm sát yêu vương.

👑 Pháp Thân 10 Khối ⚔️ +500% Sát thương ⚡ Kháng toàn bộ Lôi Kiếp 💥 Kim Thân Bất Diệt
👑
CỰ LINH PHÁP THÂN
Hóa Thần Chi Cảnh · Độc Tôn
⌘ NGỰ KIẾM PHI HÀNH · TỨ TƯỢNG HỘ THỂ

Ngự Kiếm Phi Hành
Song Kiếm Hợp Bích 360°

Ngự kiếm lướt gió 3D 360° theo tầm nhìn chuột cực mượt. Kích hoạt kiếm trận Tứ Tượng Hộ Thể vạn kiếm quy tông, chém rách hư không và dịch chuyển xuyên qua địa hình hiểm trở.

🗡️ Lướt gió 3.5x tốc độ 🎯 Điều khiển 360° góc nhìn 🌪️ Vạn Kiếm Quy Tông ✨ Tứ Tượng Hộ Thể
⚔️
SONG KIẾM PHI HÀNH
Tứ Tượng Kiếm Trận Hộ Mệnh

Bắt đầu trong vài bước

Dùng tài khoản Portal để lấy FREE hoặc liên kết Premium, sau đó cấu hình license trên Minecraft server.

  1. 01

    Tạo tài khoản Portal

    Mở Premium Owner Portal, đăng ký email và mật khẩu rồi đăng nhập. Đây là tài khoản của chủ server, không phải Owner/Admin license control.

    Mở User Portal ↗
  2. 02

    Bản FREE vĩnh viễn — Hoàn toàn không cần License Key

    Từ phiên bản v7.7.3.2, bản FREE hoạt động độc lập vĩnh viễn mà không cần đăng ký key hay liên hệ server xác thực. Chỉ cần tải file jar bỏ vào thư mục plugins/ là server khởi động và chạy full hệ thống Free ngay lập tức!

  3. 03

    Đặt license vào config

    Trong file plugins/TuTienPlugin/config.yml, cấu hình domain của license service và key mà bạn đã nhận.

    licensing:
      api-url: "https://tutien-website.vercel.app"
      key: "TTF-KEY-CUA-BAN"

    Thay domain bằng domain License Control thực tế; thay key bằng key FREE hoặc PREMIUM của bạn.

  4. 04

    Khởi động và kiểm tra

    Khởi động server, xem log plugin và xác nhận license được kích hoạt. Nếu đổi IP host, hãy liên hệ Owner để được kiểm tra binding.

Tính năng mới v7.7.3.2 Hoạt động 100% In-Game

Hệ Thống Linh Thú (Pet System) GUI 54 Ô

Linh Thú đồng hành hoàn toàn mới với giao diện rương Chest GUI 54 ô trực quan, không cần chỉnh sửa config phức tạp. Người chơi có thể 1-click triệu hồi, thu hồi, chuyển đổi 3 chế độ chiến đấu, cho ăn tăng trưởng tu vi và mở khóa thần thú theo Cảnh Giới.

⚔️

Chế độ Chủ Động (Aggressive)

Linh Thú tự động phát hiện quái vật và kẻ thù trong phạm vi xung quanh hoặc tấn công mục tiêu mà chủ nhân đang nhắm tới.

🛡️

Chế độ Hộ Vệ (Guardian)

Linh Thú luôn kề cận bảo vệ. Khi chủ nhân bị bất kỳ kẻ địch nào đánh trúng, thú cưng lập tức lao vào nghênh chiến và kích hoạt hiệu ứng phản đòn.

🕊️

Chế độ Bị Động (Passive)

Linh Thú không tham chiến, tự động đi theo hỗ trợ chủ nhân, nhặt vật phẩm rơi rớt và cung cấp hào quang hồi phục sinh lực/linh lực.

Các Lệnh Điều Khiển Linh Thú

LệnhMô tả chức năngGhi chú
/linhthu hoặc /pet, /trieuthuMở giao diện Chest GUI 54 ô quản lý toàn diện Linh Thú.1-click triệu hồi / thu hồi / đổi chế độ
Cho ăn Thảo Dược & Đan DượcĐặt thảo dược hoặc linh đan vào ô thức ăn trong GUI để tăng điểm kinh nghiệm tu vi của thú.Càng lên cấp cao, Linh Thú mở khóa thêm kỹ năng
/ttadmin linhthu give <player> <pet_id>Admin cấp trực tiếp Linh Thú vào kho của người chơi.Ví dụ ID: bach_ho, thanh_long, huyen_vu, chu_tuoc, ky_lan
/ttadmin linhthu setexp <player> <exp>Admin điều chỉnh tu vi của Linh Thú đang đồng hành.Cấp quyền cho sự kiện máy chủ
Nâng cấp V4 Đỉnh Cao JOML Matrix & Dynamic Bank Ngũ Hành Kiếm Khí

Ngự Kiếm Phi Hành V4 - Tiên Đạo Đỉnh Phong

Hệ thống Ngự Kiếm Phi Hành V4 được tái thiết kế với ma trận biến đổi JOML Quaternion chuẩn xác 100%: mũi kiếm chĩa thẳng theo hướng bay (-Z), bản dẹt kiếm nằm ngang (+Y) cho tu sĩ đứng vững, tích hợp tính năng nghiêng thân kiếm (Dynamic Banking) khi lượn vòng và tốc biến xung kích sonic.

🚀 Bay 360° & Dynamic Banking

Đồng bộ Pitch & Yaw chuẩn xác. Khi tu sĩ lượn vòng quay đầu, phi kiếm nghiêng cánh mượt mà theo góc bẻ lái như phi cơ tiên hiệp.

⚡ Phi Kiếm Tốc Biến [Shift]

Nhấn Shift khi đang ngự kiếm trên không để kích hoạt xung kích gia tốc +145%, bung tỏa sóng xung kích sonic và hào quang xé gió.

🌟 Ngũ Hành Kiếm Khí

Tùy biến 5 hệ kiếm khí: Phong Lôi (Gió xanh), Cửu Thiên Lôi (Sét tím), Chân Hỏa (Lửa đỏ), Huyền Băng (Băng tuyết), Thái Dương (Hoàng kim).

🛡️ Vạn Kiếm Hộ Thể Trận

4 luồng kiếm quang xoay quanh bảo hộ tu sĩ trên không, tự động đẩy lùi và chém phạt bất kỳ quái vật nào dám áp sát.

Lệnh sử dụng: Gõ /ngukiem để bật/tắt bay. Gõ /ngukiem he <phong|loi|hoa|bang|quang> để chọn hệ kiếm khí yêu thích. Nhấn Shift khi đang bay để phóng tốc biến!
Giao Diện Đồ Họa Dễ Dùng Cho Tân Thủ

Cẩm Nang Tu Tiên GUI Tra Cứu Trực Quan

Thay vì phải nhớ danh sách hàng chục câu lệnh phức tạp trong chat, phiên bản v7.7.3.2 cung cấp Cẩm Nang Tu Tiên GUI mở bằng lệnh /tutien guide hoặc /tutien huongdan.

📖 Hướng Dẫn Tân Thủ

Chọn class nhân vật, chọn đạo tâm, tọa thiền tích lũy linh khí ban đầu.

⚡ Đột Phá Lôi Kiếp

Xem tiến độ linh khí, vượt tâm ma, chuẩn bị pháp bảo chống đỡ thiên lôi.

🧪 Bách Nghệ Tu Chân

Công thức Luyện Đan, Luyện Khí rèn đúc pháp bảo, Trận Pháp và Linh Thực.

🏰 Tông Môn & Bí Cảnh

Gia nhập môn phái, nhận bổng lộc, tham gia cơ duyên thám hiểm di tích cổ.

Nhấp chuột vào bất kỳ mục nào trong GUI để xem chi tiết hoặc tự động chạy lệnh tương ứng ngay lập tức.

Cảnh Giới & Hệ Thống Bách Nghệ

Chuẩn mực thế giới tu tiên nguyên bản với lộ trình tu luyện trường sinh và 5 đại nghề nghiệp phụ trợ kinh điển.

🌟 8 Đại Cảnh Giới Tu Tiên

  1. 1. Luyện Khí Kỳ: Dẫn khí nhập thể, cảm ứng linh khí trời đất (Tầng 1 - 9).
  2. 2. Trúc Cơ Kỳ: Đúc nền móng đạo cơ, mở khóa ngự kiếm phi hành.
  3. 3. Kim Đan Kỳ: Ngưng tụ kim đan bất toái, thần thông sơ thành.
  4. 4. Nguyên Anh Kỳ: Phá đan hóa anh, thần hồn xuất khiếu di sơn đảo hải.
  5. 5. Hóa Thần Kỳ: Thấu hiểu thiên đạo quy tắc, thọ mệnh vạn năm.
  6. 6. Luyện Hư Kỳ: Thân thể hóa hư vô, điều khiển linh mạch càn khôn.
  7. 7. Hợp Thể Kỳ: Thần hồn và nhục thân hợp nhất, thiên địa đồng thọ.
  8. 8. Đại Thừa Kỳ: Độ kiếp phi thăng, bước vào Tiên Giới bất hủ.

🛠️ 5 Nghề Bách Nghệ (Lệnh: /bachnghe)

  • 🔥 Luyện Đan Sư: Thu hái tiên thảo từ Vườn Tiên Thảo, vận dụng Đan Lô chế tạo đan dược hồi phục, tăng tu vi và trợ giúp đột phá (/luyen).
  • ⚒️ Luyện Khí Sư: Rèn đúc thần binh bảo khí, khảm nạm ngọc thạch, thức tỉnh Khí Linh pháp bảo (/renduc, /khamnam).
  • 📜 Phù Lục Sư: Khắc họa bùa chú hộ mệnh, bùa dịch chuyển, bùa định thân và lôi phù công kích.
  • 🔮 Trận Pháp Sư: Thiết lập Hộ Sơn Đại Trận bảo vệ tông môn, Tụ Linh Trận tăng tốc độ hấp thu linh khí.
  • 🌿 Linh Thực Phu: Gieo trồng và chăm bón linh thảo quý hiếm trong vườn thảo dược (/thao).

Lệnh dành cho người chơi

Các lệnh dưới đây được đối chiếu với plugin.yml và command handler của TuTienPlugin 7.7. Một số chức năng cần chọn class/đạo trước hoặc yêu cầu đủ cảnh giới. Alias là tên gõ tắt nếu được liệt kê.

Bắt đầu nhanh: gõ /guide để xem hướng dẫn trong game; chọn class bằng /tutien chon <class>, chọn đạo bằng /tutien dao <dao>. Mã class: kiem_tu, phap_tu, y_tu, doc_tu, the_tu, quy_tu, phong_tu, hoa_tu. Mã đạo: chinh_dao, ma_dao, si_vuong, lo_vuong.
LệnhCông dụngAlias / ghi chú
/tutien guide, /guideMở Cẩm Nang Tu Tiên GUI trực quan phân loại hướng dẫn và lệnh tương tác in-game.Lệnh mới v7.7.3.2 (Alias: /tutien huongdan, /tutien lenh)
/linhthu, /petMở GUI Linh Thú 54 ô: Triệu hồi, thu hồi, đổi 3 chế độ Chủ Động/Hộ Vệ/Bị Động, cho ăn thảo dược.Lệnh mới v7.7.3.2 (Alias: /trieuthu, /ls)
/ngukiem, /swordflightNgự Kiếm Phi Hành 3D: Bay lượn 360° chuẩn xác theo cả hướng nhìn Pitch & Yaw.Đã nâng cấp 3D (Yêu cầu Trúc Cơ)
/bachngheMở giao diện Bách Nghệ: Luyện Đan, Luyện Khí, Phù Lục, Trận Pháp, Linh Thực.Hệ thống nghề nghiệp phụ trợ
/coduyenMở giao diện Cơ Duyên: Khám phá bí cảnh, kỳ ngộ giang hồ, tìm kiếm bảo vật.Thám hiểm may mắn
/guide [mục]Hướng dẫn bắt đầu, class, cảnh giới, đột phá, skill, luyện đan, pháp bảo, linh thạch, tông môn, mẹo và danh sách lệnh.Lệnh gợi ý
/tutien chon <class>Chọn class nhân vật lần đầu./tt, /tx
/tutien dao <dao>Chọn hướng đạo sau khi chọn class; các mã đạo hợp lệ được liệt kê ở đầu mục.Không phải mọi đạo đều có cùng lối chơi.
/tutien infoXem thông tin nhân vật, cảnh giới và tiến trình./tutien skill xem danh sách skill của class.
/tutien itemsLấy lại các skill item cho class hiện tại.Cảnh báo: trước khi dùng, lấy đồ khỏi hotbar slot 1–5; handler hiện tại xóa item có metadata ở 5 slot đầu.
/linhkhiXem thanh Linh Khí hiện tại.Alias: /lk
/vuottammaBắt đầu bước Vượt Tâm Ma trước khi đột phá nếu đủ điều kiện.Alias: /vtm
/dotphaBắt đầu thử thách Thiên Kiếp khi đột phá đang chờ/đủ điều kiện.Alias: /dp
/boquaHủy lượt đột phá đang chờ; Linh Khí được giữ theo xử lý hiện tại.Alias: /bq
/aura [on|off]Bật/tắt vòng hào quang tu vi.Alias: /tuvi
/thiendinh [bat|tat]Bật/tắt tọa thiền để tích lũy Linh Khí theo cấu hình.Alias: /td, /meditate
/tuitutienMở túi đồ Tu Tiên dạng GUI.Alias: /ttbag, /tuidotutien
/toc, /tutien linhcanXem thông tin Tộc và Linh Căn.Linh Căn/Tộc có thể chưa được tiết lộ ở đầu game.
/trieuthuTriệu hồi Linh Thú đồng hành.Alias: /ls, /linhthu, /pet
/trieukiem [mode], /ngukiemTriệu hồi kiếm bay và dùng Ngự Kiếm khi đáp ứng điều kiện.Trạng thái kiếm bay phụ thuộc cảnh giới/class.
/luyen, /luyen danh_sachMở GUI luyện đan hoặc xem công thức. Có thể nhập ID/tên đan dược để luyện.Alias: /ld, /luyendan
/renduc, /cuonghoaRèn đúc lên tier cao hơn hoặc cường hóa pháp bảo đang cầm.Alias: /rd, /forge; /chpb, /enhance.
/khamnam, /dunghopKhảm Nam Ngọc vào pháp bảo hoặc dung hợp hai pháp bảo cùng loại.Kiểm tra vật phẩm/nguyên liệu và chi phí trước khi thao tác.
/linhthuc, /khilinhGắn Linh Thức lên pháp bảo đang cầm hoặc cho pháp bảo hấp thụ vật phẩm rác để tích điểm Khí Linh.Alias lần lượt: /lt; /kl, /phapbaopet.
/tutien phabaoNhận một pháp bảo mẫu ngẫu nhiên theo cảnh giới hiện tại để xem thử hệ thống.Chỉ dùng nếu muốn nhận item mẫu trong inventory.
/thao, /linhchungshop <buy|sell> <herbId> [số_lượng]Xem thông tin Tiên Thảo hoặc mua/bán theo shop đã cấu hình.Alias: /herb, /thaodoc; /lcshop.
/karma, /questXem Công Đức/Nghiệp Lực và nhiệm vụ Daily/Weekly.Alias: /congduc; /nv, /nhiemvu.
/tongmonThao tác Tông Môn/Bang Hội; dùng /tongmon để xem cú pháp server hỗ trợ.Alias: /tm, /sect.
/party, /groupTạo nhóm, mời, chấp nhận, rời nhóm hoặc quản lý thành viên.Alias: /nhom; /grp.
/trade <player>, /tang <player>Mở giao dịch hoặc quy trình tặng item cho người chơi khác.Alias: /gd, /giaodich; /gift, /cho.
/suphu <player>, /dedoanMời người chơi làm đệ tử hoặc xem/quản lý quan hệ Sư Phụ–Đệ Tử.Subcommand phụ thuộc cú pháp hiển thị trong game.
/uyap [on|off|status]Bật/tắt hoặc xem trạng thái Uy Áp cảnh giới.Dùng /guide zone để đọc hướng dẫn vùng theo bản plugin.

Lệnh và alias được khai báo trong plugin.yml. Một vài tham số bổ sung có thể thay đổi theo phiên bản; có thể dùng /guide lenh và gợi ý lệnh trong game để xác nhận.

Lệnh dành cho Admin

Phần lớn lệnh quản trị yêu cầu permission tutien.admin (mặc định OP). Chỉ cấp quyền này cho người tin cậy. Các lệnh quản lý license trên Website Owner Admin là hệ thống riêng, không phải lệnh Minecraft.

LệnhCông dụng / cú pháp
/tutien reload, /ttadmin reloadTải lại toàn bộ cấu hình plugin: Linh Thú, Ngự Kiếm, Luyện Đan, Bách Nghệ, Tông Môn.
/tutien setstage <player> <stage>Đặt cảnh giới trực tiếp cho người chơi (Luyện Khí, Trúc Cơ, Kim Đan, Nguyên Anh, Hóa Thần, Luyện Hư, Hợp Thể, Đại Thừa).
/tutien addexp <player> <amount>Cộng thêm kinh nghiệm tu vi tu tiên cho người chơi.
/tutien linhthu give <player> <pet_id>Cấp Linh Thú trực tiếp vào kho lưu trữ của người chơi.
/tutien linhthu setexp <player> <exp>Chỉnh kinh nghiệm/tu vi cho Linh Thú của người chơi.
/ttadmin info <player>Xem dữ liệu tu tiên của người chơi.
/ttadmin set <field> <player> <value>Đặt trường stage/canh_gioi, tang/rank, class, dao, linhkhi/lk, tien/lt, toc, linhcan. Giá trị phải phù hợp enum/kiểu của trường.
/ttadmin give tien <player> <số_lượng>Cấp Tiền/Linh Thạch theo logic currency của plugin.
/ttadmin give linhkhi <player> <số_lượng>Cấp Linh Khí.
/ttadmin give phabao <player> [tier] [type] [số_lượng]Cấp pháp bảo; tier có các dạng code như ha, trung, thuong, de, tien hoặc tên enum hợp lệ.
/ttadmin give <player> <PHABAO_ID> [số_lượng]Cú pháp nhanh cấp trực tiếp loại pháp bảo đã biết ID. Ví dụ ID phải tồn tại trong enum PhaBaoType.
/ttadmin reset <player> confirmReset dữ liệu nhân vật sau khi gõ chính xác từ xác nhận confirm.
/ttadmin list, /ttadmin top [type]Liệt kê người đang online và xem bảng xếp hạng.
/ttadmin heal <player|all>Hồi máu cho một người hoặc toàn bộ người chơi online.
/ttadmin maxlk <player>, /ttadmin maxlk_allĐưa Linh Khí lên mức tối đa cho một người hoặc tất cả người chơi online.
/ttadmin zone create [radius] [type] [name]Tạo zone tại vị trí Admin đang đứng; list để liệt kê, remove <id> để xóa.
/ttadmin vuon tao <tên> [radius]Tạo khu vườn tiên thảo tại vị trí Admin; dùng /ttadmin vuon list hoặc /ttadmin vuon xoa <tên> để quản lý.
/ttadmin thao give <player> <herbId> [amount]Cấp thảo dược theo ID đã khai báo trong herbs.types.
/ttadmin thao seed <player> <herbId> [amount]Cấp hạt giống cho herb có plantable: true.
/ttadmin bidong_sach <player> <atk|hp|def|speed|luck|regen>Cấp Sách Bí Kíp Bị Động theo key hợp lệ.
/ttadmin dotpha <player>, /ttadmin dotpha_token <player> [STAGE]Ép bắt đầu thử thách đột phá hoặc cấp Đột Phá Lệnh theo cảnh giới.
/ttadmin worldboss spawn|despawn|statusĐiều khiển Boss Tối Thượng hoặc xem trạng thái.
/ttadmin bloodmoon start|stop|statusBắt đầu, dừng hoặc kiểm tra sự kiện Huyết Nguyệt. Lệnh alias standalone là /bloodmoon cũng cần quyền admin.
/ttadmin season set <CLASS> <DAO>Đặt meta mùa bằng enum class và đạo; clear để xóa, info để xem.
/ttadmin broadcast <nội_dung>Gửi thông báo tới toàn bộ người online.
/ttadmin reloadReload config và các manager được nối với thao tác reload: Pet Tier, Luyện Đan, Vườn Tiên Thảo và config state. Sao lưu config trước khi chỉnh.
/addlinhzone <tên> [bán_kính], /debug [on|off]Lệnh tiện ích admin được khai báo riêng trong plugin.yml; đều yêu cầu permission quản trị.
Ghi chú kiểm tra source: nhánh /ttadmin arena trong source hiện tại chỉ trả thông báo hướng dẫn/chưa triển khai chức năng arena. Không nên xem đây là tính năng arena hoạt động cho đến khi được lập trình hoàn chỉnh.

PlaceholderAPI & BetterHud

TuTien đăng ký expansion có prefix tutien khi PlaceholderAPI đã được cài và plugin khởi động thành công. Dùng nguyên placeholder trong scoreboard, hologram hoặc text field của HUD có hỗ trợ PlaceholderAPI.

1. Cài và kiểm tra

  1. Cài PlaceholderAPI phù hợp phiên bản Paper/Purpur và đặt jar vào thư mục plugins/.
  2. Khởi động/restart server, kiểm tra log xem expansion TuTien đã đăng ký hay chưa.
  3. Chạy hai lệnh thử bên dưới. Nếu kết quả vẫn là chuỗi placeholder nguyên văn, kiểm tra PlaceholderAPI, log và phiên bản plugin.
/papi parse me %tutien_stage%\n/papi parse me %tutien_lk_bar%\n/papi parse me %tutien_power_score%
NhómPlaceholderTrả về
Cảnh giới / xếp hạng%tutien_stage%, %tutien_stage_plain%, %tutien_rank%, %tutien_rank_name%, %tutien_full%, %tutien_full_color%, %tutien_realm%, %tutien_power_score%Giai đoạn, tầng, tên cảnh giới; power_score là số để sort leaderboard.
Linh Khí%tutien_lk%, %tutien_lk_max%, %tutien_lk_percent%, %tutien_lk_bar%, %tutien_lk_short%, %tutien_lk_short_max%, %tutien_lk_ready%Hiện tại/tối đa, %, progress bar, số rút gọn, trạng thái đủ Linh Khí.
Tiền%tutien_lt%, %tutien_tien%, %tutien_lt_short%, %tutien_tien_short%Linh Thạch/Tiền theo data của nhân vật và dạng rút gọn.
Nhân vật%tutien_class%, %tutien_dao%, %tutien_toc%, %tutien_toc_color%, %tutien_lingcan%, %tutien_thienmeng%Class, đạo, tộc, Linh Căn và Thiên Mệnh (nếu đã có dữ liệu).
Chiến đấu%tutien_kills%, %tutien_deaths%, %tutien_boss_kills%, %tutien_pvp_kills%, %tutien_boss_toithuong_kills%, %tutien_bt_success%, %tutien_bt_fail%, %tutien_kd%Thống kê hạ gục, chết, boss, PvP, đột phá và K/D.
Karma / trạng thái%tutien_karma_cong%, %tutien_karma_nghiep%, %tutien_karma_grade%, %tutien_in_trial%, %tutien_pending_bt%, %tutien_aura%Công Đức, Nghiệp Lực, bậc Karma, trạng thái Thiên Kiếp/đột phá và aura.
Ban board%tutien_ban_<n>_name%, %tutien_ban_<n>_reason%, %tutien_ban_<n>_duration%Thông tin người bị ban thứ n trong danh sách cache; n bắt đầu từ 1. Ví dụ %tutien_ban_1_name%.
BetterHud 2.x: cấu trúc file có thể khác giữa phiên bản. Cài BetterHud và PlaceholderAPI trước, copy một text/layout mẫu do đúng bản BetterHud tự sinh, rồi thay nội dung text bằng placeholder như %tutien_full_color% hoặc %tutien_lk_bar%. Sau khi nối text vào HUD/layout, dùng lệnh reload theo tài liệu của bản BetterHud đang cài. Không copy YAML từ bản khác mà chưa kiểm tra schema.

Hướng dẫn lấy vật phẩm hỗ trợ

Vật phẩm có thể đến từ gameplay, công thức, lệnh cấp phát của Admin hoặc hệ thống drop. Tỉ lệ/ID cụ thể phụ thuộc cấu hình server.

⚔ Skill Items

Chọn class/đạo theo tiến trình nhân vật để plugin cấp bộ skill item. Nếu thiếu item, dùng /tutien items sau khi cất toàn bộ đồ quan trọng khỏi hotbar slot 1–5.

/tutien chon kiem_tu
/tutien dao chinh_dao
/tutien items
✦ Pháp Bảo

Quái bị hạ có tỉ lệ cơ bản 5% rơi Pháp Bảo theo code hiện tại; vật phẩm thường được đưa thẳng vào inventory. Có thể dùng lệnh mẫu trong game để thử.

/tutien phabao

Lưu ý khi cấu hình: code combat hiện dùng xác suất cố định 5% (random.nextInt(20) == 0). Key phabao.drop-rate-multiplier có trong config nhưng chưa thấy được áp dụng trong nhánh drop này, nên thay key đơn lẻ có thể chưa đổi được tỉ lệ.

☘ Tiên Thảo / Linh Chủng

Tìm/hái các node thảo dược đã cấu hình trong vùng vườn. Một số loại có thể rơi hạt; cây trồng yêu cầu khu vườn được tạo bởi Admin và đủ cảnh giới.

/ttadmin vuon tao vuon1 25
/ttadmin thao give <player> linh_thao 3
/ttadmin thao seed <player> linh_thao 2

Hai lệnh cấp vật phẩm chỉ dùng cho Admin. Với người chơi, thu hoạch/gieo theo cơ chế gameplay trong vùng vườn.

📘 Sách Bí Kíp Bị Động

Sách được Admin cấp hoặc qua hệ thống phần thưởng nếu server cấu hình. Cầm sách và học một trong các loại key hợp lệ; giới hạn hiện tại là tối đa 3 passive.

/ttadmin bidong_sach <player> atk
/hocbidong atk
/bidong

Key được source hỗ trợ: atk, hp, def, speed, luck, regen.

⚗ Đan dược

Mở GUI bằng /luyen, xem danh sách bằng /luyen danh_sach. Đọc công thức trong alchemy.recipes để chuẩn bị vật liệu vanilla và loại thảo dược cần thiết.

/luyen
/luyen danh_sach
/luyen linh_khi_dan
🐾 Linh Thú / Kiếm Bay

Dùng lệnh triệu hồi tương ứng sau khi server bật hook/phần phụ thuộc cần thiết; một số loại bị giới hạn theo class/cảnh giới.

/trieuthu
/trieukiem
/ngukiem

Nếu không hoạt động, kiểm tra log hook và cấu hình tính năng thay vì tự cài thêm ID không có trong config.

Cách cấu hình plugin

File chính là plugins/TuTienPlugin/config.yml, được tạo khi chạy plugin lần đầu. Sao lưu file trước khi chỉnh và giữ đúng kiểu dữ liệu YAML (thụt lề bằng dấu cách, không dùng tab).

Các nhóm cấu hình thường dùng

`licensing`

`api-url`, `key`, `offline-grace-hours`. Đặt domain License Control công khai và key TTF/TTP đã nhận; production không nên để `127.0.0.1`.

`skills`

`cooldown-multiplier`, `damage-multiplier`, `mana-cost-multiplier`, `enabled`. Các ID skill phải khớp key mà SkillManager đọc.

`economy`

Tên tiền hiển thị, mức thưởng khi hạ mob/player, hệ số loại mob, chi phí reroll, shop, rèn đúc và tạo tông môn.

`phabao`

Giới hạn pháp bảo, trọng số type, cường hóa, socket, fusion, affix và Linh Thức. Lưu ý: drop-rate-multiplier có trong YAML nhưng combat source hiện đang kiểm tra drop bằng xác suất cố định 5%; muốn chỉnh tỉ lệ cần nối key này vào code.

`herb-garden` / `herbs.types`

Bật/tắt vườn, yêu cầu vùng vườn, thời gian respawn, lượng rơi, cơ hội rơi hạt và ID từng thảo dược; chú ý `plantable` và `seed-block`.

`alchemy.recipes`

Mỗi recipe có `name`, `min-stage`, `success-rate`, `craft-time-seconds`, `materials`, `herbs`, `effects`. Vật liệu dùng dạng `MATERIAL:số_lượng`; herb dùng `herb_id:số_lượng`.

`world-boss`

Bật boss, mob ID MythicMobs, mức mob, lịch spawn, world/toạ độ, cảnh báo, timeout và phần thưởng. Đảm bảo mob ID tồn tại nếu bật hook MythicMobs.

`effects.itemsadder`

`enabled`, `animation`, `lifetime-ticks`, `map`. Map dùng effect key → `namespace:entity_id`. ID phải đúng resource ItemsAdder của server; để trống sẽ dùng particle fallback theo logic plugin.

Ví dụ: bật/tắt skill và chỉnh multiplier

skills:
  cooldown-multiplier: 1.0
  damage-multiplier: 1.0
  mana-cost-multiplier: 1.0
  enabled:
    kiem-khi-tran: true
    toc-kiem: true
    thien-sat: true

phabao:
  drop-rate-multiplier: 1.0
  max-phabao-per-player: 6

Đây là ví dụ trích theo key có trong config; hãy giữ các key/nhóm còn lại của file mặc định để tránh làm mất thiết lập khác.

Ví dụ: map hiệu ứng ItemsAdder cho skill riêng

effects:
  itemsadder:
    enabled: true
    animation: ""
    lifetime-ticks: 100
    map:
      thi-trien-ky-nang: "tutien:vfx_skill_chung"
      skill-toc_kiem: "tutien:vfx_toc_kiem"
      phabao-loiphu: "tutien:vfx_loiphu"

Các ID trong ví dụ là tên mẫu để minh họa cú pháp; hãy thay bằng entity/ID thật tồn tại trong resource pack ItemsAdder của bạn. Key tổng quát và key riêng được đọc theo cấu trúc có chú thích trong config hiện tại.

Áp dụng config: kiểm tra YAML trước khi restart. /ttadmin reload hiện gọi reload cho config state, Pet Tier, Luyện Đan và Vườn Tiên Thảo; không nên mặc định rằng mọi subsystem đều reload toàn bộ an toàn. Với thay đổi cốt lõi hoặc hook, hãy lên lịch restart và kiểm tra console.

Bảng giá các gói

Giá, thời hạn và quyền lợi được lấy từ cấu hình công khai trong Owner Admin. Owner có thể cập nhật danh sách gói mà không cần sửa HTML.

Đang tải bảng giá…
Giá Premium chưa niêm yết sẽ hiển thị “Liên hệ”. Website hiện chưa tích hợp thanh toán tự động; nút hành động có thể được Owner trỏ tới shop hoặc kênh liên hệ.
Đang tải dữ liệu gói…

FREE khác PREMIUM ở đâu?

Bảng dưới được Owner chỉnh trực tiếp trong mục Gói & Giá. Nếu quyền lợi thay đổi, hãy cập nhật bảng so sánh trước khi công bố.

Tính năng◇ FREE✦ PREMIUM
Đang tải bảng so sánh…
Quyền lợi hiển thị theo cấu hình Owner công bố. Điều khoản/license thực tế được xác định theo gói đã cấp.

License & host binding

FREE · TTF-…

Tự nhận license vĩnh viễn

Mỗi tài khoản Portal nhận một FREE key. License được bind vào IP host Minecraft và installation khi kích hoạt.

PREMIUM · TTP-…

Mở quyền Premium

Nhập key Premium vào Portal. Máy chủ kiểm tra loại gói, trạng thái, thời hạn và liên kết tài khoản trước khi mở Skin Studio.

Lưu ý: IP host không phải định danh tuyệt đối — host dùng NAT hoặc thay IP có thể cần Owner xử lý unbind. Không đăng công khai license key, token quản trị hay mật khẩu.

Skill Skin Studio

Người dùng Premium có thể chỉnh mapping cho từng effect key, xem preview YAML, lưu cấu hình riêng và tải file để merge vào cấu hình Minecraft.

01 · Chọn effect

Dùng effect key đúng với tên mà hook plugin gọi.

02 · Gán ItemsAdder ID

ID thường có dạng namespace:entity_id và phải tồn tại trong resource pack/server.

03 · Lưu & xuất YAML

Portal lưu theo license Premium, sau đó cho tải YAML để chủ server merge thủ công. Hiện chưa tự đồng bộ realtime xuống server.

Mở Premium Owner Portal ↗

Câu hỏi thường gặp

FREE có hết hạn không?

Không. FREE được thiết kế vĩnh viễn, nhưng vẫn phải tuân theo trạng thái license, host binding và điều khoản sử dụng.

Có thể mua Premium trực tiếp trên Wiki không?

Mở Premium Owner Portal để chọn gói. Khi cấu hình thanh toán đã được Owner bật, Portal hỗ trợ chuyển khoản/VietQR, MoMo hoặc PayPal; license chỉ được cấp sau khi backend xác minh giao dịch.

Vì sao tôi không mở được Skill Skin Studio?

Bạn cần đăng nhập Portal và liên kết/mua một license PREMIUM còn hiệu lực. Khi đã xác minh, Premium Owner Hub và Skin Studio sẽ xuất hiện. Nếu đã mua bằng tài khoản khác, hãy đăng nhập đúng tài khoản đã nhận key hoặc liên kết key Premium.

Tôi đã mua Premium nhưng không thấy Owner Hub?

Đăng nhập tài khoản Portal đã dùng lúc mua. Nếu Owner cấp key riêng, nhập key tại mục TuTien PREMIUM rồi bấm Xác minh & liên kết. Chỉ license Premium hợp lệ, chưa hết hạn hoặc bị thu hồi mới mở được bảng cấu hình.

Mở Premium Owner Portal ↗
Tôi đổi IP host thì sao?

License đang bound IP cũ có thể từ chối host mới. Liên hệ Owner để xác minh và gỡ binding có kiểm soát.

Tu Tiên Wiki · Documentation & PricingUser Portal ·

Giá và quyền lợi được hiển thị theo cấu hình do Owner công bố. Vui lòng xác nhận điều khoản, thời hạn license và kênh mua với Owner trước khi thanh toán.