1. MÔ TẢ | DESCRIPTION - Plugin sự kiện câu cá, bảng xếp hạng, phần thưởng, bossbar, reload, shop, đa ngôn ngữ, hỗ trợ PlaceholderAPI và hologram. - A fishing event plugin with leaderboard, rewards, bossbar, reload, shop, multi-language, PlaceholderAPI and hologram support.
- Tương thích Paper/Spigot <1.12.2-1.13+. - Compatible with Paper/Spigot <1.12.2-1.13+.
2. LỆNH CHÍNH | MAIN COMMANDS Sử dụng: /cauca <subcommand> hoặc /fish <subcommand> Usage: /cauca <subcommand> or /fish <subcommand>
- start | batdau : Bắt đầu sự kiện câu cá → Start the fishing event
- stop | dung : Dừng sự kiện → Stop the event
- top : Xem bảng xếp hạng sự kiện → View event leaderboard
- list | danhsach : Danh sách cá đặc biệt → List of special fish
- reload | tai-lai : Tải lại cấu hình plugin → Reload plugin configuration
- clear : Xóa bảng xếp hạng hiện tại → Clear current leaderboard
- setworld : Thêm thế giới hiện tại vào danh sách cho phép câu cá → Add current world to allowed fishing worlds
- shop : Mở shop cá (chưa hoàn thiện) → Open fish shop (incomplete)
- info : Thông tin plugin → Plugin information
- reward : Xem phần thưởng top → View top rewards
- help | trogiup : Trợ giúp → Help
Ví dụ: Example:
/cauca start /cauca start
/cauca top /cauca top
/fish list /fish list
3. QUYỀN | PERMISSIONS - cauca.admin : Toàn quyền quản lý sự kiện, reload, clear, setworld, v.v. → Full access to manage the event, reload, clear, setworld, etc.
- cauca.user : Quyền mặc định cho người chơi sử dụng các lệnh top, list, shop. → Default permission for players to use top, list, and shop commands.
4. PLACEHOLDERAPI Plugin hỗ trợ các placeholder sau (dùng cho Hologram, tablist, scoreboard...) The plugin supports the following placeholders (for use in Holograms, tablists, scoreboards...)
%cauca_top_1_name% : Tên người chơi top 1 → %cauca_top_1_name% : Top 1 player name
%cauca_top_1_fish% : Tên cá top 1 → %cauca_top_1_fish% : Top 1 fish name
%cauca_top_1_length% : Chiều dài cá top 1 → %cauca_top_1_length% : Top 1 fish length
%cauca_top_2_name% : Tên người chơi top 2 → %cauca_top_2_name% : Top 2 player name
%cauca_top_2_fish% : Tên cá top 2 → %cauca_top_2_fish% : Top 2 fish name
%cauca_top_2_length% : Chiều dài cá top 2 → %cauca_top_2_length% : Top 2 fish length
%cauca_top_3_name% : Tên người chơi top 3 → %cauca_top_3_name% : Top 3 player name
%cauca_top_3_fish% : Tên cá top 3 → %cauca_top_3_fish% : Top 3 fish name
%cauca_top_3_length% : Chiều dài cá top 3 → %cauca_top_3_length% : Top 3 fish length
Có thể dùng %cauca_top_N_name%, %cauca_top_N_fish%, %cauca_top_N_length% với N = 1..10 You can use %cauca_top_N_name%, %cauca_top_N_fish%, %cauca_top_N_length% with N = 1..10
5. CẤU HÌNH | CONFIGURATION - Sửa file config.yml để chỉnh thời gian event, thời gian lặp lại, danh sách thế giới được phép... - Edit config.yml to change event duration, repeat interval, allowed worlds, etc.
- Sửa file fish.yml để thêm/xóa/sửa các loại cá đặc biệt, tỉ lệ, phần thưởng. - Edit fish.yml to add/remove/edit special fish, chance, rewards.
- Sửa file message.yml để thay đổi ngôn ngữ, thông báo. - Edit message.yml to change language and messages.
event:
min-players: 2
announce-start: true
announce-end: true
default-duration: 10m
time: 10p # Thời gian diễn ra sự kiện (ví dụ: 10p)
restart: 5p # Thời gian lặp lại sự kiện (ví dụ: 5p)
reward:
enabled: true
type: command
command: "eco give %player% 500"
item:
type: DIAMOND
amount: 3
display-name: "&bCá Quý"
lore:
- "&7Phần thưởng sự kiện câu cá"
- "&aGiá trị cao!"
enabled-worlds:
- world
- world_nether
- world_the_end
help: |
&eCác lệnh CauCa:
&e/cauca start &7- Bắt đầu sự kiện
&e/cauca stop &7- Dừng sự kiện
&e/cauca top &7- Xem bảng xếp hạng
&e/cauca list &7- Danh sách cá
&e/cauca reload &7- Tải lại cấu hình
&e/cauca help &7- Trợ giúp
contest.started: "&aSự kiện câu cá đã bắt đầu!"
contest.stopped: "&cSự kiện đã kết thúc!"
leaderboard.title: "&6Bảng xếp hạng câu cá"
fish.list: "&bDanh sách cá đặc biệt:"
reload.success: "&aĐã tải lại cấu hình!"
rare-catch-broadcast: "&d%player% &7vừa câu được cá hiếm: &b%fish% &7[Độ hiếm: %rarity% - Chiều dài: %length%cm]!"
6. LƯU Ý | NOTES - Bảng xếp hạng sẽ reset mỗi khi sự kiện mới bắt đầu. - Leaderboard resets when a new event starts.
- Nếu không có cá trong fish.yml, khi câu sẽ báo “cá không xác định”. - If fish.yml is empty, caught fish will show as "unknown fish".
- Để hiển thị top lên Hologram, dùng PlaceholderAPI với HolographicDisplays hoặc plugin tương tự. - To display top players in a hologram, use PlaceholderAPI with HolographicDisplays or a similar plugin.
- Tính năng kết hợp với vật phẩm MMOitem đang thử nghiệm - Feature combined with MMOitem items is being tested