SoulboundArsenal (Bản Fix Lỗi)
SoulboundArsenal là plugin RPG/PvP/SMP xoay quanh hệ thống Soulbound — mỗi người chơi sở hữu một Linh Hồn riêng, phát triển theo Level, Tier và Skill.Plugin biến các công cụ Minecraft quen thuộc thành một hệ thống chiến đấu và tiến trình riêng, kết hợp 5 loại Soul, 25 kỹ năng, Level, Tier, Combo, Kill Streak, Achievement, Ranking, Terrain Skill, Economy và hệ thống bảo vệ Soul Item.
Phiên bản hiện tại: 1.16.11
✦ TỔNG QUAN
Khi người chơi lần đầu tham gia server, hệ thống sẽ cho phép họ nhận một trong 5 loại Soul:- Sword Soul
- Axe Soul
Pickaxe Soul- Shovel Soul
- Hoe Soul
Soul Item được liên kết với người chơi thông qua hệ thống dữ liệu riêng, giúp bảo vệ vật phẩm khỏi việc trao đổi, sao chép hoặc sử dụng trái phép.
5 LOẠI SOUL
Sword Soul
Phong cách chiến đấu trực diện, cơ động và thiên về sát thương.Skill
- Blood Slash
- Shadow Step
- Crimson Mark
- Soul Blade
- Reaper
Axe Soul
Phong cách chiến đấu nặng, tập trung vào sát thương lớn và kiểm soát khu vực.Skill
- Heavy Strike
- Axe Throw
- Timber Crash
- Execution Zone
- Lumberjack
Pickaxe Soul
Phong cách thiên về sức mạnh địa chất, di chuyển và kiểm soát địa hình.Skill
- Ore Sense
- Tunnel Dash
- Earth Breaker
- Seismic Wave
- Earthquake
Shovel Soul
Phong cách kiểm soát mặt đất, khống chế và tạo địa hình.Skill
- Sand Blast
- Earth Wall
- Ground Trap
- Ground Wave
- Landslide
Hoe Soul
Phong cách thiên về sinh lực, hồi phục và sức mạnh tự nhiên.Skill
- Nature Slash
- Life Drain
- Healing Field
- Thorn Garden
- Nature's Wrath
HỆ THỐNG LEVEL & PROGRESSION
Soul có hệ thống Level với giới hạn có thể điều chỉnh thông qua config.Tiến trình không còn phụ thuộc vào các giá trị hard-code cố định. Các yêu cầu mở khóa Skill có thể cấu hình thông qua:
progression:<br> skill-requirements:<br>
Cho phép server tự cân bằng thời điểm người chơi mở khóa từng kỹ năng.
Hệ thống progression hỗ trợ các nguồn EXP khác nhau và lưu lại tiến trình của người chơi một cách an toàn.
TIER SYSTEM
Soul được chia thành nhiều Tier tương ứng với quá trình phát triển của người chơi:WOOD<br>STONE<br>IRON<br>DIAMOND<br>NETHERITE<br>
Tier, Level và các yêu cầu progression có thể được điều chỉnh tùy theo cách server muốn xây dựng gameplay.
SOUL ITEM PROTECTION
Soul Item là một trong những hệ thống cốt lõi của SoulboundArsenal.Plugin sử dụng dữ liệu PDC để xác định Soul Item thay vì chỉ dựa vào tên hoặc Lore.
Mỗi Soul Item có thể chứa các thông tin như:
- Owner UUID
- Soul ID
- Soul Type
- Tier
- Level
- Item Version
- Signature
SIGNATURE V2 & ITEM MIGRATION
SoulboundArsenal 1.16.x nâng cấp hệ thống bảo mật Soul Item lên Signature v2.Hệ thống hỗ trợ:
- Signature v2
- PDC version
- Kiểm tra tính hợp lệ của item
- Migration item phiên bản cũ
- Khôi phục item an toàn
️ ANTI-COPY & INVENTORY PROTECTION
Plugin tích hợp cơ chế bảo vệ Soul Item trước nhiều hình thức sao chép và thao tác inventory không hợp lệ.Hỗ trợ kiểm soát:
- Creative Clone
- Drop
- Chest
- Hopper
- Các thao tác inventory đặc biệt
- Các tình huống chuyển đổi item
- Soul Item không thuộc chủ sở hữu
protection:<br> block-drop: true<br> block-container: true<br> block-hopper: true<br>
RESTORE KHI TÚI ĐẦY
SoulboundArsenal đã xử lý trường hợp inventory không còn chỗ trống khi cần restore Soul Item.Plugin không ghi đè Slot 0 hoặc các slot hiện có để ép đưa Soul Item vào inventory.
Thay vào đó:
Inventory đầy<br>↓<br>Không ghi đè item hiện tại<br>↓<br>Đưa Soul Item vào trạng thái chờ<br>↓<br>Theo dõi inventory<br>↓<br>Có slot trống<br>↓<br>Restore an toàn<br>
Điều này giúp giảm nguy cơ mất item hoặc ghi đè vật phẩm của người chơi.
AUTO-RESTORE
Tính năng Auto-Restore hiện có thể bật/tắt bằng config:settings:<br> auto-restore: true<br>
Server có thể chủ động lựa chọn cách xử lý Soul Item khi cần khôi phục.
SMART TERRAIN ROLLBACK
Một số kỹ năng có khả năng tương tác trực tiếp với địa hình.SoulboundArsenal sử dụng cơ chế Smart Rollback thay vì rollback mù.
Ví dụ:
Skill tạo block<br>↓<br>Player phá block đó<br>↓<br>Rollback<br>↓<br>Không tự động dựng lại block đã bị player thay đổi<br>
Điều này giúp giảm tình trạng rollback ghi đè lên những thay đổi hợp lệ của người chơi.
SKILL SYSTEM
Plugin hiện có 25 Skill, tương ứng với 5 loại Soul.Skill có hệ thống progression và yêu cầu mở khóa riêng.
Ngoài damage/effect, Skill còn có các cơ chế như:
- Cooldown
- Level requirement
- Kill requirement
- Combat interaction
- Safe Zone protection
- Particle
- Sound
- Feedback
- Terrain interaction
ĐỔI SKILL BẰNG SHIFT + CUỘN
Cách đổi Skill đã được cải thiện đáng kể.Khi người chơi:
Giữ Shift + cuộn chuột trên Soul Item
plugin sẽ chuyển Skill mà không làm nhảy ô hotbar hoặc làm người chơi rời khỏi Soul Item đang cầm.
Sau khi đổi Skill, người chơi nhận được phản hồi trực tiếp:
Title<br>+<br>Action Bar<br>+<br>[X/5]<br>+<br>Tên Skill<br>+<br>Sound / Particle<br>
Ví dụ:
[3/5] Crimson Mark<br>
giúp người chơi dễ nhận biết Skill hiện tại hơn.
COMBO & KILL STREAK
Plugin có hệ thống:- Combo
- Kill Streak
- Kill Tracking
- Death Tracking
DEATH SYSTEM
SoulboundArsenal hiện hỗ trợ lưu Deaths đầy đủ trong cả YAML và SQLite.Dữ liệu có thể sử dụng cho:
- Statistics
- Ranking
- PlaceholderAPI
- K/D Ratio
%soulbound_deaths%<br>%soulbound_kd%<br>
PERSISTENT COOLDOWN
Cooldown có thể được lưu vào database tùy theo cấu hình:combat:<br> persist-cooldowns: true<br>
Khi được bật, cooldown có thể được duy trì qua các lần reconnect/restart theo cơ chế lưu trữ của plugin.
Database có bảng riêng cho cooldown.
RANDOM SOUL
Hệ thống Random Soul được thiết kế lại để kiểm soát chính xác trạng thái bảo vệ người chơi.Khi GUI Random Soul đang mở hoặc người chơi đang trong quá trình Roll:
Người chơi được bảo vệ khỏi damage.
Trong thời gian này:
- Không nhận damage
- Không gây damage
- Không mất đói
Quan trọng
Bảo vệ chỉ tồn tại trong thời gian GUI đang mở hoặc đang Roll.Nếu người chơi nhấn ESC để đóng GUI:
GUI đóng<br>↓<br>Bảo vệ mất ngay lập tức<br>
Plugin không tự động mở lại GUI.
Người chơi có thể mở lại bằng:
/soul chon<br>
Khi GUI được mở lại, cơ chế bảo vệ mới được kích hoạt lại theo đúng trạng thái hiện tại.
RANDOM CONFIG
Hệ thống Random Soul hỗ trợ cấu hình:random:<br> animation-ticks:<br> save-pending:<br>
Các thiết lập này được sử dụng để kiểm soát animation và trạng thái Random Soul.
️ DATABASE & MIGRATION
SoulboundArsenal sử dụng SQLite để lưu dữ liệu.Database có hệ thống:
schema_version<br>
và hỗ trợ migration theo từng phiên bản:
v1<br>↓<br>v2<br>↓<br>v3<br>
Mục tiêu là cập nhật cấu trúc database mà không cần xóa dữ liệu người chơi.
Các dữ liệu quan trọng có thể bao gồm:
- Soul
- Level
- XP
- Kills
- Deaths
- Achievement
- Cooldown
- Progression
- Các dữ liệu khác của hệ thống
PLACEHOLDERAPI
SoulboundArsenal hỗ trợ PlaceholderAPI dưới dạng Soft Dependency.Plugin vẫn có thể khởi động khi PlaceholderAPI không được cài đặt.
Một số Placeholder:
%soulbound_deaths%<br>%soulbound_kd%<br>
Các placeholder khác có thể cung cấp thông tin về Soul, Level, Tier, XP và progression tùy cấu hình/version.
CONFIG “SỐNG”
Một trong những thay đổi quan trọng của các bản 1.16.x là đưa nhiều hệ thống trước đây phụ thuộc vào code cố định trở thành config thực sự có tác dụng.Ví dụ:
protection:<br> block-drop:<br> block-container:<br> block-hopper:<br><br>settings:<br> auto-restore:<br> max-level:<br><br>random:<br> animation-ticks:<br> save-pending:<br><br>debug:<br> enabled: false<br><br>combat:<br> persist-cooldowns: true<br><br>progression:<br> skill-requirements:<br>
Các thiết lập này được thiết kế để thay đổi behavior của plugin thay vì chỉ tồn tại trong config.
MESSAGES.YML
Các thông báo hệ thống được tách khỏi Java code và đưa vào:messages.yml<br>
Có thể tùy chỉnh các message như:
- Cooldown
- Inventory đầy
- Random Soul
- Death
- Level Up
- Skill
- Restore
- Security
- Các thông báo hệ thống khác
RELOAD
Có thể reload plugin thông qua:/souladmin reload<br>
Sau khi reload, các thiết lập được cấu hình lại mà không cần khởi động lại toàn bộ server.
️ RANDOM PROTECTION — LOGIC MỚI
Cơ chế bảo vệ Random Soul trong 1.16.11 được thiết kế theo trạng thái GUI./soul chon<br> ↓<br>GUI mở<br> ↓<br>Bảo vệ ON<br> ↓<br>Player Roll<br> ↓<br>Bảo vệ ON<br> ↓<br>ESC<br> ↓<br>GUI đóng<br> ↓<br>Bảo vệ OFF<br>
Không còn trường hợp người chơi đóng GUI nhưng vẫn giữ trạng thái bất tử ngoài ý muốn.
ACHIEVEMENT
Hệ thống Achievement giúp ghi nhận quá trình phát triển và các thành tích của người chơi.Achievement được lưu trữ để không bị mất sau khi:
- Logout
- Restart server
- Reload plugin
RANKING
SoulboundArsenal có hệ thống Ranking dựa trên dữ liệu progression của người chơi.Các chỉ số liên quan tới Soul, Kill, Death và K/D có thể được sử dụng để xây dựng hệ thống xếp hạng của server.
️ SAFE ZONE
Có thể thiết lập khu vực Safe Zone để kiểm soát:- PvP
- Skill
- Damage
- Terrain
- Các cơ chế combat khác
ECONOMY
SoulboundArsenal hỗ trợ Vault cho các tính năng Economy.Server có thể tích hợp plugin Economy hiện có thay vì phải sử dụng hệ thống tiền riêng.
COSMETIC
Plugin có hệ thống Cosmetic và hiệu ứng hiển thị dành cho người chơi.Các hiệu ứng được thiết kế tách biệt với gameplay nhằm hạn chế ảnh hưởng tới cân bằng chiến đấu.
SEASONAL SYSTEM
Hỗ trợ các cơ chế Event/Seasonal có thể bật tắt và điều chỉnh theo cấu hình server.Phù hợp với:
- PvP Event
- Double EXP Event
- Seasonal Event
- Server Event
️ ADMIN TOOLS
Các công cụ quản trị được cung cấp thông qua:/souladmin<br>
Bao gồm các nhóm chức năng quản lý Soul, Player, Level, Tier, Skill, Repair, Diagnose, Database, Event và Configuration.
PERFORMANCE & STABILITY
Các bản cập nhật 1.16.x tập trung đáng kể vào độ ổn định của plugin.Đã cải thiện:
- Logging
- Error handling
- Database migration
- Cooldown persistence
- Inventory restore
- Terrain rollback
- Configuration handling
- Optional dependency handling
CHANGELOG 1.16.11
SoulboundArsenal 1.16.11
Fixed
- Sửa đổi Skill bằng Shift + cuộn không còn làm nhảy hotbar.
- Giữ nguyên slot Soul Item đang cầm khi chuyển Skill.
- Cải thiện feedback khi đổi Skill.
- Title hiển thị Skill hiện tại.
- Action Bar hiển thị thứ tự [X/5].
- Bổ sung tên Skill vào feedback.
- Bổ sung Sound/Particle feedback khi đổi Skill.
- Random Soul chỉ bảo vệ người chơi khi GUI mở hoặc đang Roll.
- ESC đóng Random GUI sẽ mất bảo vệ ngay lập tức.
- Không tự động mở lại Random GUI.
- Bổ sung /soul chon để mở lại giao diện Random Soul.
- Khi đang được bảo vệ bởi Random Soul, người chơi không gây hoặc nhận damage.
- Không mất đói trong trạng thái bảo vệ Random Soul.
Improved
- Restore Soul Item khi inventory đầy.
- Signature v2.
- PDC version.
- Migration Soul Item cũ.
- Smart Terrain Rollback.
- Config được sử dụng thực tế.
- Auto Restore có thể bật/tắt.
- Max Level có thể cấu hình.
- Skill requirement theo progression.
- Persistent Cooldown.
- Death tracking.
- PlaceholderAPI integration.
- Messages system.
- Logging và error handling.
CHANGELOG CÁC PHIÊN BẢN 1.16.x
1.16.1 – 1.16.3
- Cải thiện restore khi inventory đầy.
- Cải thiện Terrain System.
- Nâng cấp Signature.
1.16.4 – 1.16.5
- Cải thiện Configuration System.
- Max Level có thể cấu hình.
1.16.6 – 1.16.7
- Persistent Cooldown.
- Bổ sung Death Tracking.
1.16.8 – 1.16.9
- Cải thiện Logging.
- Bổ sung messages.yml.
1.16.10
- Fix Shift + cuộn để đổi Skill.
- Cải thiện Random Soul Protection.
1.16.11
- ESC đóng GUI sẽ lập tức kết thúc Protection.
- Không tự động mở lại Random GUI.
- /soul chon mở lại Random GUI khi cần.
THÔNG TIN PLUGIN
Tên: SoulboundArsenalPhiên bản: 1.16.11
Thể loại: RPG / SMP / PvP / Survival
Soul: 5
Skill: 25
Tier: 5
Database: SQLite
Configuration: YAML
Messages: messages.yml
Placeholder: PlaceholderAPI
Integration: Vault / WorldGuard
Ngôn ngữ: Tiếng Việt / English
GAMEPLAY FLOW
NGƯỜI CHƠI MỚI<br> ↓<br>/soul chon<br> ↓<br>RANDOM SOUL<br> ↓<br>NHẬN SOUL ITEM<br> ↓<br>TĂNG LEVEL<br> ↓<br>MỞ KHÓA SKILL<br> ↓<br>NÂNG TIER<br> ↓<br>COMBO / KILL STREAK<br> ↓<br>ACHIEVEMENT / RANKING<br> ↓<br>PHÁT TRIỂN SOUL<br>
TỔNG KẾT
SoulboundArsenal được xây dựng để trở thành một hệ thống Soul Progression hoàn chỉnh cho các server Minecraft RPG, SMP và PvP.Mỗi người chơi không chỉ sở hữu một công cụ mạnh hơn theo thời gian mà còn có một Linh Hồn riêng với tiến trình, kỹ năng và phong cách chiến đấu riêng.
Với phiên bản 1.16.11, plugin tiếp tục tập trung vào ba yếu tố chính:
Gameplay — Security — Stability
Mục tiêu là cung cấp một hệ thống Soul vừa có chiều sâu gameplay, vừa dễ cấu hình và an toàn cho server production.
Link Tải: https://drive.google.com/file/d/1LN-Vj21VXrwo4v4ZpfVztrh1naKv6HVB/view?usp=sharing
