SLBossSpawner

OverviewTổng quan

InstallationCài đặt

• + Install MythicMobs 5.x (required dependency)
• + Place SLBossSpawner-2.0.0.jar into plugins/
• + Restart the server — config files are generated automatically
• + Edit configs in plugins/SLBossSpawner/
• + Run /slboss reload to apply changes

• + Cài MythicMobs 5.x (bắt buộc phải có)
• + Bỏ file SLBossSpawner-2.0.0.jar vào thư mục plugins/
• + Restart server — các file config sẽ được tạo tự động
• + Chỉnh cấu hình trong plugins/SLBossSpawner/
• + Gõ /slboss reload để áp dụng

config.yml

# SLBossSpawner Configuration
prefix: "&#FF6B6B[&#FFD93DSLBossSpawner&#FF6B6B] "
debug: false
language: "vi"   # "en" = English, "vi" = Tieng Viet

schedules.yml

Each top-level key defines a boss with its MythicMob, schedule, location, and broadcast settings.

Mỗi khoá cấp cao nhất là một Boss, gồm thông tin MythicMob, lịch spawn, vị trí và cài đặt thông báo.

boss:                          # Boss ID (must match reward.yml)
  mythicmob: SkeletonKing     # MythicMobs internal name
  expire: 3600                # Despawn after 3600s (1 hour)
  clearOnExpire: true          # Remove entity when expired
  time-settings:
    zone: Asia/Ho_Chi_Minh    # IANA timezone
    time:
      - "12:00"               # Spawn at noon
      - "18:00"               # Spawn at 6 PM
      - "21:00"               # Spawn at 9 PM
  location:
    x: 100  y: 64  z: -200
    world: bossworld
    leashRadius: 10           # Max wander distance (0 = no limit)
  loadChunks: true             # Force-load spawn chunk
  broadcast:
    death:
      chat: true  title: true
    spawn-warning:
      chat: true  title: true  bossbar: true
      intervals: [30, 15, 5, 1]  # Warning at X minutes before spawn

reward.yml

Reward configuration per boss. Each boss has 3 categories: damage, tank, support — each with configurable tiers.

Cấu hình phần thưởng cho từng Boss. Mỗi Boss có 3 hạng mục: sát thương, chịu đòn, hỗ trợ — mỗi hạng mục chia thành nhiều bậc thưởng khác nhau.

boss:                               # Must match schedules.yml ID
  enabled: true
  item-protection:
    enabled: true
    duration: 60                   # Seconds before expiry
    expire-action: public          # "public" or "despawn"
  last-hit-bonus:
    multiplier: 1.5                # Bonus for the killing blow
  global-multiplier: 1.0           # Multiply all item amounts

  damage:                            # Damage category
    enabled: true
    tiers:
      1:                              # Rank #1
        multiplier: 3.0
        commands:
          - "eco give {player} 5000"
        drop-tables:
          - "BossLootTable"
        items:
          - type: vanilla
            material: DIAMOND
            amount: 5
            display-name: "&#FFD93D&lTop 1 Damage"

# Vanilla Minecraft item
- type: vanilla
  material: DIAMOND
  amount: 5
  display-name: "&#FFD93D&lCustom Name"

# MMOItems item (requires MMOItems plugin)
- type: mmoitems
  material: SWORD           # MMOItems type
  id: "CUSTOM_SWORD"        # MMOItems ID
  amount: 1

# MythicMobs item (built-in)
- type: mythicmobs
  material: "CustomItem"   # MythicMobs internal name
  amount: 1

Player TrackingTheo dõi người chơi

SLBossSpawner tracks player contributions in 3 independent categories during boss fights:

Trong mỗi trận đánh Boss, plugin sẽ theo dõi đóng góp của người chơi qua 3 hạng mục riêng biệt:

Reward SystemHệ thống phần thưởng

How It Works

Cách hoạt động

1. Boss dies — MythicMobDeathEvent triggers reward distribution
2. Rankings built — Players sorted by contribution per category
3. Tier matching — Rank #1 gets tier 1 rewards, rank #2 gets tier 2, etc.
4. Multipliers applied — tier x global x last-hit-bonus (if applicable)
5. Rewards delivered — Commands executed, items given (or dropped with protection)
6. Offline queue — If player is offline, rewards are saved and delivered on next join

1. Boss chết — MythicMobDeathEvent kích hoạt việc chia thưởng
2. Lập bảng xếp hạng — Người chơi được xếp theo đóng góp ở mỗi hạng mục
3. Ghép bậc thưởng — Hạng 1 nhận thưởng bậc 1, hạng 2 nhận bậc 2, v.v.
4. Áp hệ số nhân — bậc x toàn cục x thưởng đòn kết liễu (nếu có)
5. Phát thưởng — Chạy lệnh, trao đồ vào túi (hoặc rơi ra kèm bảo vệ nếu túi đầy)
6. Hàng đợi offline — Người chơi đang offline sẽ nhận thưởng khi đăng nhập lại

BroadcastsThông báo

Spawn Warnings

Cảnh báo trước khi spawn

Countdown warnings are sent at configured intervals (in minutes) before boss spawn. Channels: chat, title, bossbar — each independently toggleable.

Thông báo đếm ngược được gửi theo các mốc thời gian (tính bằng phút) trước khi Boss xuất hiện. Có 3 kênh: chat, title, bossbar — mỗi kênh bật/tắt riêng.

Death Announcements

Thông báo khi Boss bị hạ

When a boss dies, announcements show the killer's name. Ranking leaderboards display the top contributors per category.

Khi Boss bị tiêu diệt, hệ thống sẽ thông báo tên người hạ gục. Bảng xếp hạng hiển thị top người đóng góp theo từng hạng mục.

Item ProtectionBảo vệ vật phẩm

When a player's inventory is full, reward items drop on the ground with owner-only pickup protection.

Khi túi đồ người chơi đầy, vật phẩm thưởng sẽ rơi xuống đất và được khoá cho chủ nhân — chỉ người đó mới nhặt được.

1. Item dropped → tagged with owner UUID via PersistentDataContainer
2. Other players cannot pick up — shown actionbar denial message
3. After duration seconds, based on expire-action:
   • public — Protection removed, anyone can pick up
   • despawn — Item removed from the world

1. Vật phẩm rơi ra → được gắn UUID chủ nhân qua PersistentDataContainer
2. Người khác nhặt sẽ bị từ chối, kèm thông báo trên actionbar
3. Sau duration giây, tuỳ theo expire-action:
   • public — Bỏ khoá, ai nhặt cũng được
   • despawn — Vật phẩm biến mất

PersistenceLưu trữ dữ liệu

Boss State

Trạng thái Boss

Active bosses are saved to boss-state.yml and restored on server restart. If a boss expired during downtime, it's skipped and rescheduled.

Boss đang hoạt động sẽ được lưu vào boss-state.yml. Khi server khởi động lại, Boss sẽ được phục hồi. Nếu đã hết hạn trong lúc tắt server thì bỏ qua và lên lịch mới.

Offline Rewards

Phần thưởng khi offline

Rewards for offline players are saved to pending-rewards.yml and automatically delivered when the player joins (2-second delay for safe loading).

Nếu người chơi offline lúc nhận thưởng, phần thưởng sẽ được lưu vào pending-rewards.yml. Khi họ vào lại server, hệ thống tự động trao sau 2 giây (chờ load xong cho chắc).

Statistics & LeaderboardThống kê & Bảng xếp hạng

Tracked Metrics

Chỉ số theo dõi

Period Types

Loại kỳ

Statistics are tracked across 7 period types: daily, weekly, monthly, quarterly, seasonal, yearly, alltime. Old periods are automatically archived.

Thống kê được theo dõi qua 7 loại kỳ: daily, weekly, monthly, quarterly, seasonal, yearly, alltime. Các kỳ cũ tự động được lưu trữ.

Leaderboard Cache

Cache bảng xếp hạng

An in-memory cache refreshes every cache.refresh-seconds (default 60s). All placeholder reads are instant and non-blocking. Cache covers ALL_TIME and DAILY periods for all 11 metrics.

Bộ nhớ đệm được làm mới mỗi cache.refresh-seconds (mặc định 60 giây). Tất cả placeholder đọc từ cache, không gây lag. Cache bao gồm kỳ ALL_TIME và DAILY cho tất cả 11 chỉ số.

Database Configuration

Cấu hình cơ sở dữ liệu

statistics:
  enabled: true
  database:
    type: sqlite          # sqlite or mysql
    table-prefix: "slbs_"
    mysql:
      host: localhost
      port: 3306
      database: minecraft
      username: root
      password: ""
      pool-size: 5
  cache:
    refresh-seconds: 60
    leaderboard-size: 100

CommandsLệnh

Placeholders

Requires PlaceholderAPI. Prefix: %slbs_<bossId>.<key>%

Cần cài PlaceholderAPI. Cú pháp: %slbs_<bossId>.<key>%

Boss Placeholders

Placeholder Boss

Leaderboard Placeholders

Placeholder bảng xếp hạng

Reads from in-memory cache (non-blocking). Returns --- if rank not available.

Đọc từ bộ nhớ đệm (không gây lag). Trả về --- nếu hạng không có.

Periods: alltime, daily, weekly/week, monthly/month, quarterly/quarter, seasonal/season, yearly/year

Các kỳ: alltime, daily, weekly/week, monthly/month, quarterly/quarter, seasonal/season, yearly/year

Player Stats Placeholders

Placeholder thống kê người chơi

Shows requesting player's value from cache. Returns 0 if player not in top N.

Hiện giá trị của người chơi từ cache. Trả về 0 nếu không trong top N.

PermissionsQuyền

ChangelogNhật ký thay đổi

v3.0.0 (2026-02-27)

Added

Thêm mới

• SQLite/MySQL database for persistent player statistics
• Cơ sở dữ liệu SQLite/MySQL để lưu thống kê người chơi
• 11 tracked metrics across 7 period types (daily → all-time)
• 11 chỉ số theo dõi qua 7 loại kỳ (hàng ngày → toàn thời gian)
• /slboss stats [player] — view player statistics
• /slboss stats [player] — xem thống kê người chơi
• /slboss top <metric> [period] [boss] — leaderboard with tab completion
• /slboss top <metric> [period] [boss] — bảng xếp hạng có tab-complete
• Leaderboard & stats PlaceholderAPI expansions (with period support: daily, weekly, monthly, etc.)
• Placeholder PlaceholderAPI cho bảng xếp hạng & thống kê (hỗ trợ theo kỳ: ngày, tuần, tháng, v.v.)
• In-memory leaderboard cache with async refresh
• Bộ nhớ đệm bảng xếp hạng với làm mới bất đồng bộ
• Automatic period archival (daily, weekly, monthly, etc.)
• Tự động lưu trữ kỳ cũ (ngày, tuần, tháng, v.v.)
• Code architecture improvements: AbstractBossTracker, CommandValidator, ItemFactory
• Cải thiện kiến trúc code: AbstractBossTracker, CommandValidator, ItemFactory

Fixed

Sửa lỗi

• Reload-safe flag to suppress death-event processing during reload
• Cờ an toàn khi reload để bỏ qua sự kiện chết trong lúc reload
• Delayed state restore by 2 ticks to ensure worlds are loaded
• Trì hoãn khôi phục trạng thái 2 tick để đảm bảo thế giới đã tải
• Only send spawn success if boss actually spawned
• Chỉ gửi thông báo thành công nếu boss thực sự xuất hiện

v2.0.1 (2026-02-11)

Security

Bảo mật

• Drop table name sanitization to prevent command injection
• Khử độc tên bảng drop để ngăn chặn command injection
• Command validation to block shell metacharacters
• Xác thực lệnh để chặn metacharacter shell

Fixed

Sửa lỗi

• Duplicate stopTracking() calls, volatile bossScheduler, YAML parsing, forceSpawn reschedule
• Gọi stopTracking() trùng, volatile bossScheduler, phân tích YAML, lên lịch lại forceSpawn

v2.0.0 (2026-02-11)

Initial release with scheduled spawning, damage/tank/support tracking, tiered rewards, persistence, PlaceholderAPI, and multi-language support.

Bản phát hành đầu tiên với spawn theo lịch, theo dõi sát thương/chịu đòn/hỗ trợ, phần thưởng theo bậc, lưu trữ, PlaceholderAPI, và hỗ trợ đa ngôn ngữ.