TuTiên Plugin v4 — Hướng Dẫn & Thay Đổi

📜

NHẬT KÝ THAY ĐỔI

Toàn bộ thay đổi qua các phiên bản

v4.0 MAJOR 2026-05

MỚI MythicMobs Hook — Boss Arena tự động dùng MythicMobs mob khi detect được plugin. 11 loại boss template với phase system, skill phức tạp (beam, barrage, slam). Tương thích cả FREE 4.x và Premium 5.x. Không có MM thì tự fallback về vanilla.

MỚI MythicLib Stats Hook — Đăng ký 6 custom stat vào MythicLib: linh_khi_regen, phap_cong, phap_phong, linh_khi_max, boss_dmg_reduce, crit_lk_mult. Equipment MythicMobs có thể boost trực tiếp các stat này.

MỚI Realm Aura (MythicMobs) — Mỗi cảnh giới lớn có hiệu ứng Aura particle riêng cast qua MythicMobs skill system. Tự cập nhật khi đột phá lên tầng mới.

MỚI Tộc & Linh Căn Effect (MM) — Long Tộc, Phượng Hoàng, Hỗn Hiệp, Kim Cương, Đạo Tộc, Thủy Tinh Tộc; Linh Căn HON/HUYET/CO_HO/THIEN_NHAT/NGUYEN_SHI/VO_THUONG — mỗi loại có hiệu ứng MythicMobs skill riêng khi kích hoạt.

HỆ THỐNG 2 bản phân phối riêng — TuTien-FREE.rar (21 skill, tương thích MM Free 4.x) và TuTien-PREMIUM.rar (28 skill, đầy đủ cho MM5 Premium + phase system).

FIX pom.xml — Xóa dependency MythicLib/MythicMobs khỏi Maven (JAR premium không có trên repo public). Hook dùng 100% Java reflection nên không cần compile-time dependency.

FIX TT_Bosses.yml — Fix ArmorToughness thành block Attributes: GENERIC_ARMOR_TOUGHNESS đúng chuẩn MM5. Fix Equipment format GOLDEN_SWORD:0 HAND → GOLDEN_SWORD MAINHAND. Thêm skill còn thiếu TT_UltraRage và TT_UltraDeath.

v3.1 2026-05

FIX EffectEngine — Đổi org.bukkit.entity.FireworkRocket → org.bukkit.entity.Firework (class đúng trong Paper 1.21). Đổi local var fw → rocket tránh xung đột tên method. TocType dùng fully-qualified name thay import.

FIX MythicLibHook — Sửa 7 lỗi cannot-find-symbol: getLinhCanElements()→getLinhCan(), getAtkBonus()→getAtkMult(), getDefBonus()→getDefMult(), getCritBonus()→getBreakDiffMult().

v3.0 MAJOR 2026-05

MỚI 30 tầng cảnh giới Tối Thượng — Sinh Si → Thủy Tinh Vĩnh Hằng, mỗi tầng 8 cấp nhỏ. Boss Arena cấp độ 19-48: Dual Final → Triple → Omega → Song Omega → Tam Omega → Tứ Omega (HP lên đến 90.000❤ + 8.000/level).

MỚI 8 Linh Căn siêu cấp — HON (Hỗn Độn), HUYET (Huyết Mạch), CO_HO (Cổ Ho), THIEN_NHAT (Thiên Nhất), NGUYEN_SHI (Nguyên Thủy), VO_THUONG_CAN (Vô Thượng Căn). Thêm method isSieuCap().

MỚI 6 Tộc siêu hiếm — Phượng Hoàng (hồi sinh khi HP=0), Thượng Thần (sét), Hỗn Hiệp (hút máu), Kim Cương (bất tử 5 giây), Đạo Tộc (tự đột phá), Thủy Tinh Tộc (x3 mọi chỉ số, cực hiếm 0.000001%).

MỚI EffectEngine v3 — Hoàn toàn viết lại. Xoáy helo kép, sóng lôi động AoE, sphere 3D, spiral, firework đa lớp, boss spawn 4-tầng, hiệu ứng riêng từng cảnh giới, linh căn, tộc. Action bar tiến trình lôi kiếp real-time.

CẢI THIỆN Damage & Wave scaling — Tầng Tối Thượng: 75%→93% HP damage/sóng, 165→455 sóng. Mạnh hơn 18 tầng siêu cấp (66%→74%, 75→160 sóng).

CẢI THIỆN Boss Arena mở rộng — Boss level 1-48, Omega Boss spawn theo nhóm 1/2/3/4 con. Timeout 8 phút, vòng barrier bán kính 9 block cao 5+mái.

v2.0 MAJOR 2026-05

MỚI 18 tầng Siêu Cấp + Boss Arena — Khai Nguyên → Tuyệt Đỉnh Vô Thượng. Khi đột phá chuyển tầng lớn: Lôi Kiếp mạnh hơn bình thường + vòng tròn BARRIER nhốt player solo boss. Hạ boss → đột phá thành công.

MỚI TribulationBossArena — Class mới quản lý vòng đấu. Barrier wall + ceiling, boss HP scale, timeout, player death detection, broadcastb khi boss xuất hiện.

CẢI THIỆN Cảnh giới tổng cộng 71 tầng (53 cũ + 18 siêu cấp), cấu trúc mỗi tầng 8 cấp nhỏ. Stage mới trở thành final: TUYET_DINH_VO_THUONG.

v1.0 BASE Gốc

CORE Hệ thống tu luyện cơ bản: 53 cảnh giới, Linh Khí, Thiên Kiếp, Linh Căn (10 loại), Tộc (6 loại), Công Pháp (10 loại), Pháp Bảo, Luyện Đan, Thảo Dược, Kiếm Bay, Tông Môn, Nhà Đấu Giá, Huyết Nguyệt.

KÝ HIỆU LỆNH

<bắt buộc> — Phải nhập

[tùy chọn] — Có thể bỏ qua

Alias = lệnh rút gọn (/dp = /dotpha)

Một số lệnh cần đủ cảnh giới mới dùng được

Linh Thạch (LT) là tiền tệ chính

/guide — xem hướng dẫn chi tiết trong game

🔍

⚡ TU LUYỆN & ĐỘT PHÁ 5

/tutien/tt /tx

Lệnh chính — xem thông tin nhân vật, chọn đường tu, xem pháp bảo, bảng xếp hạng.

/dotpha/dp

Bắt đầu Thiên Kiếp đột phá. Phải đủ Linh Khí. Tầng 18+ siêu cấp & 30 tầng tối thượng → xuất hiện Boss Arena! Phải solo hạ boss mới qua.

/dotpha

/boqua/bq

Bỏ qua thông báo đột phá — sẽ nhắc lại lần sau khi LK đầy.

/boqua

/linhkhi/lk

Xem thanh Linh Khí hiện tại, phần trăm đã tích lũy, ước tính thời gian đầy.

/linhkhi

/thiendinh/tdLinh Mạch x3

Thiền định — ngồi tọa tu hấp thụ LK tự động. Vào vùng Linh Mạch thì tốc độ x3.

/thiendinh [bat|tat]

🗡️ KỸ NĂNG & PHÁP BẢO 4

/skill

Mở bảng kỹ năng — xem skill đang sở hữu, cooldown, điều kiện cảnh giới yêu cầu.

/skill

/renduc/rd /forge

Rèn đúc nâng cấp Pháp Bảo: Hạ Phẩm → Trung → Thượng → Đế → Tiên Phẩm. Tốn Linh Thạch.

/renduc

/trieukiem/tkBan Thánh+

Triệu hồi Kiếm Bay — cưỡi kiếm di chuyển trên không. Yêu cầu từ Ban Thánh trở lên.

/trieukiem

/aura/tuviMM Aura

Bật/tắt vòng Tu Vi phát sáng. Nếu có MythicMobs: aura particle đẹp hơn, tự đổi theo cảnh giới.

/aura [on|off]

🌿 LUYỆN ĐAN & THẢO DƯỢC 3

/luyen/ld

Mở GUI luyện đan — chọn công thức, chuẩn bị nguyên liệu và LT để chế tạo. 28+ loại Linh Đan.

/luyen [ten_dan|danh_sach]

hoi_sinh_danho_the_dan toc_hoa_dan+25 loại

/thao/herb

Xem kho Tiên Thảo. Thu thập bằng cách phá block tương ứng hoặc chuột phải (cooldown 3 phút, không phá block).

/thao

/gongfa/gf /congphap

Xem và thay đổi Công Pháp tu luyện — ảnh hưởng tốc độ LK và chỉ số chiến đấu. 10 loại công pháp.

/gongfa [doi <ten>]

☯ NHÂN VẬT & TỘC 2

/toc12 tộc

Xem thông tin Tộc: tên, chỉ số bonus, kỹ năng thụ động. 6 tộc mới siêu hiếm: Phượng Hoàng, Thượng Thần, Hỗn Hiệp, Kim Cương, Đạo Tộc, Thủy Tinh.

/toc

/guide/hd

Hướng dẫn chi tiết tất cả tính năng trong game.

💎 KINH TẾ & GIAO DỊCH 6

/linhthach/lt

Xem/tặng Linh Thạch, reroll Linh Căn hoặc Tộc (tốn LT).

/linhthach [xem|tang|reroll|reroll_toc]

/tui/tuilinh

Túi Linh Thạch Vô Hạn — lưu trữ không giới hạn, nạp/rút/tặng bất kỳ lúc nào.

/tui [xem|nap|rut|tang]

/tuitutien/ttbag

Túi Đồ Tu Tiên — kho 54 ô riêng chỉ chứa vật phẩm tu tiên.

/tuitutien

/auction/ah

Nhà Đấu Giá — đăng bán Pháp Bảo/Linh Đan, mua vật phẩm từ người khác.

/auction [sell <gia>|cancel|myitems]

/trade/gd

Giao dịch an toàn — hai bên xác nhận trước khi hoàn tất.

/trade <player>

/tang/gift /cho

Tặng vật phẩm đang cầm trên tay cho người chơi khác ngay lập tức.

/tang <player>

⛩️ TÔNG MÔN & NHÓM 3

/tongmon/tm /sect

Quản lý Tông Môn — tạo, mời, kick, kho, xếp hạng tông trên server.

/tongmon [tao|moi|kick|roi|rank|kho|info]

/party/nhom

Nhóm cùng tu tiên — đi cùng chia sẻ buff, tham gia Boss Arena hỗ trợ.

/binhxl/binh

Dùng Bình Huyết Nguyệt trong sự kiện — chọn: tấn công, farm vật phẩm, hồi máu đội.

/binhxl [cong|farm|heal]

QUYỀN ADMIN

Yêu cầu quyền tutien.admin hoặc OP

/ttadmin give có thể phá cân bằng nếu dùng bừa

/bloodmoon ảnh hưởng toàn server — thông báo trước

Chỉnh config xong phải /ttadmin reload mới apply

🔍

⚙️ QUẢN TRỊ CHÍNH 1

/ttadmin/ttaOP Only

Lệnh admin tổng hợp — quản lý người chơi, cấp vật phẩm, reset, reload config.

/ttadmin <lenh> [args]

give <player> <item> <so> setcanhgioi <player> <canh_gioi> setlt <player> <so> reset <player> info <player> reload ban <player>

🌙 SỰ KIỆN SERVER 1

/bloodmoon/hnServer-wide

Kích hoạt Huyết Nguyệt — tăng drop rate toàn server, spawn mob boss mạnh hơn. Người chơi dùng Bình Huyết Nguyệt trong sự kiện.

/bloodmoon [start|stop|status]

🗺️ VÙNG & BẢN ĐỒ 1

/addlinhzone/alzOP Only

Tạo vùng Linh Mạch tại vị trí hiện tại — người chơi vào vùng này hấp thụ LK nhanh gấp 3. Tạo ít nhất 1 vùng khi setup server.

/addlinhzone <ten> [ban_kinh]

🔑 PHÂN QUYỀN & CONFIG 3

tutien.adminPermission Node

Node quyền cho toàn bộ lệnh admin. Mặc định chỉ OP. Gán qua LuckPerms:

/lp group admin permission set tutien.admin true

config.ymlConfig

File cấu hình trong plugins/TuTienPlugin/. Chỉnh tỉ lệ drop, hệ số LK, boss HP multiplier, giá reroll.

/ttadmin reload ← sau khi sửa xong

lk_regen_rateboss_hp_multiplier herb_drop_ratereroll_lt_cost

/mm reloadMythicMobs

Reload MythicMobs sau khi copy file YAML boss/skill. Chạy lệnh này trong game sau khi cài YAML của TuTiên.

/mm reload

📋

HƯỚNG DẪN CÀI ĐẶT

Từng bước thiết lập server từ đầu

Cài server Paper 1.21.1+

Tải Paper tại papermc.io. Bắt buộc dùng Paper — không dùng Spigot thuần (thiếu Paper API). Java 21 trở lên.

# Khởi động lần đầu để sinh eula.txt
java -Xmx4G -jar paper-1.21.1.jar --nogui
# Chấp nhận EULA rồi khởi động lại

Cài plugin bắt buộc

Copy các JAR vào thư mục plugins/:

Cài MythicMobs (tùy chọn)

Không có thì plugin vẫn chạy — boss dùng vanilla mob. Có thì boss đẹp hơn, có skill và phase system.

FREE: tải SpigotMC miễn phí. PREMIUM 5.x: mua tại mc.mythiccraft.io (cần thêm MythicLib.jar).

plugins/
  MythicMobs.jar     ← bắt buộc cho hook
  MythicLib.jar      ← chỉ cần với Premium 5.x

Copy YAML MythicMobs (nếu dùng MM)

Trong RAR → thư mục file/mythicmobs/ → copy sang:

Mobs/TT_Bosses.yml   →  plugins/MythicMobs/Mobs/TT_Bosses.yml
Skills/TT_Skills.yml →  plugins/MythicMobs/Skills/TT_Skills.yml

Sau khi copy: gõ /mm reload trong game.

Cài TuTiênPlugin

Lấy JAR trong thư mục target/ của RAR. Copy vào plugins/ rồi khởi động server.

plugins/TuTienPlugin-1.0.0.jar ← copy vào đây

Lần đầu chạy sẽ sinh plugins/TuTienPlugin/config.yml.

Kiểm tra console

Server khởi động sẽ in trạng thái hook:

[TuTienPlugin] ✅ MythicLib kết nối — 6 stats đã đăng ký.
[TuTienPlugin] ✅ MythicMobs kết nối — Boss Arena sẵn sàng.
[TuTienPlugin] ℹ️ WorldGuard không tìm thấy — bỏ qua.

Thấy ✅ = hook hoạt động. Không thấy = plugin chưa cài đúng hoặc sai version.

Thiết lập ban đầu

# Tạo Linh Mạch đầu tiên
/addlinhzone LinhSon 20

# Bảo vệ vùng Arena (nếu có WorldGuard)
//wand  →  chọn vùng  →  /rg define TT_Arena
/rg flag TT_Arena pvp allow
/rg flag TT_Arena mob-spawning allow

# Cấp quyền admin cho staff
/lp group admin permission set tutien.admin true

⚖️

FREE vs PREMIUM

So sánh 2 bản phân phối TuTien-FREE.rar và TuTien-PREMIUM.rar

Cả 2 bản đều dùng chung 1 file JAR plugin (TuTienPlugin-1.0.0.jar). Khác nhau ở file YAML MythicMobs và version MythicMobs server cần cài.

Tính năng	TuTien-FREE	TuTien-PREMIUM
MythicMobs yêu cầu	Free 4.x hoặc 5.x Free	Premium 5.x
MythicLib	Không cần	Cần (3.x+)
Số lượng skills	21 skills	28 skills + phức tạp hơn
Phase System (boss chuyển giai đoạn)	Không có	Có (2-5 phase)
Effect:Beam (tia Omega)	Không có	Có (TT_OmegaBeam)
Projectile phức tạp	Không có	Có (TT_WitherSkull với trail)
ArmorToughness (GENERIC)	Không có	Có (Attributes block)
Skill Phase Transition (reset buff)	Không có	Có (TT_PhaseTransition)
MythicLib Stats Sync	Không có	Có (6 custom stats)
Boss HP & ATK	Tương đương	Tương đương (scale khác nhau)
11 loại boss template	Có	Có
Realm Aura particle	Có (đơn giản hơn)	Có (đầy đủ)
Tộc & Linh Căn effect	Không có trong YAML	Có (16 effect skills)
Vanilla fallback khi không có MM	Có	Có
Phù hợp	Server không có MM premium, muốn thử	Server có MM Premium, muốn full features

Khuyến nghị: Nếu server đã có MythicMobs Premium 5.x thì dùng bản PREMIUM để có đầy đủ tính năng. Nếu chỉ có bản Free hoặc chưa cài MM thì dùng FREE — plugin vẫn hoạt động hoàn toàn bình thường với vanilla boss.