1. Download MMOUltraBoss-1.2.0.jar from SpigotMC
2. Stop your server
3. Place JAR file in /plugins/ directory
4. Start your server
5. Plugin auto-configures - no setup needed!
 

Console Output (Success):
[INFO] [MMOUltraBoss] Loading MMO Ultra Boss v1.2.0...
[INFO] [MMOUltraBoss] Database initialized successfully
[INFO] [MMOUltraBoss] All managers loaded successfully
[INFO] [MMOUltraBoss] Plugin enabled in XXXms
 

/skills           - Open skills GUI (any player)
/skillsadmin      - Admin panel (operators only)
/skills top       - View leaderboards
 

plugins/MMOUltraBoss/
├── config.yml              # Main configuration
├── data/
│   ├── database.db         # SQLite database (auto-created)
│   └── StatsPlayers/       # JSON player stats (v1.2.0+)
│       ├── uuid1.json
│       └── uuid2.json
├── languages/
│   ├── en.yml              # English (default)
│   ├── pt_BR.yml           # Portuguese Brazil
│   ├── es.yml              # Spanish
│   ├── it.yml              # Italian
│   ├── ru.yml              # Russian
│   └── zh_CN.yml           # Chinese Simplified
└── logs/                   # Debug logs (if enabled)
 

# Plugin Language (en, pt_BR, es, it, ru, zh_CN)
language: "en"

# Debug mode (verbose logging)
debug: false

# Database type (sqlite, mysql)
storage:
  type: "sqlite"
 
# MySQL settings (only if type: mysql)
mysql:
  host: "localhost"
  port: 3306
  database: "mmoultraBoss"
  username: "root"
  password: "password"
  ssl: false
 

# Global XP multiplier (affects all skills)
global-multiplier: 1.0

# Per-skill multipliers
skill-multipliers:
  mining: 1.0
  woodcutting: 1.0
  farming: 1.2        # 20% bonus XP
  fishing: 0.8        # 20% less XP (harder skill)
  # ... all 10 skills

# Permission-based XP bonuses
permission-multipliers:
  "mmo.multiplier.vip": 1.5      # VIP = 1.5x XP
  "mmo.multiplier.premium": 2.0   # Premium = 2x XP
  "mmo.multiplier.ultimate": 3.0  # Ultimate = 3x XP
 

anti-afk:
  enabled: true
  max-gains-per-minute: 10    # Max XP gains per minute
  penalty-duration: 300       # Penalty duration (seconds)
  penalty-multiplier: 0.1     # 90% XP reduction during penalty
 

boss-bar:
  enabled: true
  duration: 5                 # Seconds to show boss bar
  style: "SOLID"             # SOLID, SEGMENTED_6, SEGMENTED_10, etc.
 
  # Per-skill colors
  colors:
    mining: "BLUE"
    woodcutting: "GREEN"
    farming: "YELLOW"
    fishing: "BLUE"
    # ... all skills
 

mmo.skills.use              # Use /skills command (default: true)
mmo.skills.top              # Use /skills top command (default: true)
mmo.skills.others           # View other players' skills (default: op)
mmo.bossbar.toggle          # Toggle boss bar on/off (default: true)
 

mmo.admin                   # Full admin access (default: op)
mmo.admin.setlevel         # Set player skill levels
mmo.admin.addxp            # Add XP to players
mmo.admin.reload           # Reload configuration
mmo.admin.debug            # Access debug commands
 

mmo.multiplier.vip         # 1.5x XP multiplier
mmo.multiplier.premium     # 2.0x XP multiplier
mmo.multiplier.ultimate    # 3.0x XP multiplier
mmo.multiplier.staff       # 5.0x XP multiplier (custom)
 

# Basic player permissions
/lp group default permission set mmo.skills.use true
/lp group default permission set mmo.skills.top true
/lp group default permission set mmo.bossbar.toggle true

# VIP rank with XP bonus
/lp group vip permission set mmo.multiplier.vip true
/lp group vip parent add default

# Staff permissions
/lp group staff permission set mmo.admin true
/lp group staff permission set mmo.multiplier.staff true
 

{
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "playerName": "Steve",
  "lastUpdated": "2025-10-17T15:30:45Z",
  "skills": {
    "mining": {
      "level": 85,
      "currentXP": 1250.5,
      "totalXPGained": 425000,
      "actionsPerformed": 8500,
      "abilities": {
        "ability_1": 8,    # Double Drop (rank 8/10)
        "ability_2": 7,    # Super Speed (rank 7/10)
        "ability_3": 6,    # Efficient Mining (rank 6/10)
        "ability_4": 5,    # Fortune Boost (rank 5/10)
        "ability_5": 4,    # Blast Mining (rank 4/10)
        "ability_6": 0,    # Locked (needs level 90)
        "ability_7": 0,    # Locked (needs level 100)
        "ability_8": 0,    # Locked
        "ability_9": 0,    # Locked
        "ability_10": 0    # Locked
      }
    },
    "woodcutting": {
      "level": 50,
      "currentXP": 0.0,
      "totalXPGained": 125000,
      "actionsPerformed": 2500,
      "abilities": {
        "ability_1": 5,    # Tree Feller
        "ability_2": 4,    # Leaf Blower
        "ability_3": 3,    # Nature's Blessing
        "ability_4": 2,    # Wood Splitting
        "ability_5": 1,    # Bark Shield
        "ability_6": 0,    # Locked
        "ability_7": 0,    # Locked
        "ability_8": 0,    # Locked
        "ability_9": 0,    # Locked
        "ability_10": 0    # Locked
      }
    }
  }
}
 

# Step 1: Stop server or ensure player is offline
/stop

# Step 2: Edit JSON file in StatsPlayers/
# Example: Boost mining level to 1000
"mining": {
  "level": 1000,
  "currentXP": 0.0,
  "totalXPGained": 999999999,
  "abilities": {
    "ability_1": 0,    # Will auto-unlock to rank 10
    "ability_2": 0,    # Will auto-unlock to rank 10
    # ... all abilities will auto-unlock
  }
}

# Step 3: Start server
# Plugin will auto-correct and unlock all abilities based on level 1000

# Step 4: Check console for confirmation
[INFO] Auto-unlocking MINING ability 1 for Steve (Level 1000 >= required 10) with rank 10
[INFO] Auto-unlocking MINING ability 2 for Steve (Level 1000 >= required 20) with rank 10
[INFO] Player Steve data was modified from JSON. Syncing with database...
 

Level 1→2:     1,000 XP
Level 2→3:     2,000 XP
Level 3→4:     3,000 XP
...
Level 99→100:  99,000 XP
Level 100+:    100,000 XP per level

Formula: XP_needed = level * 1000
Total XP to reach level N = (N * (N-1) / 2) * 1000
 

Ability 1:  Level 10    (Early game)
Ability 2:  Level 20
Ability 3:  Level 30
Ability 4:  Level 40
Ability 5:  Level 50    (Mid game)
Ability 6:  Level 60
Ability 7:  Level 70
Ability 8:  Level 80
Ability 9:  Level 90    (Late game)
Ability 10: Level 100   (End game)
 

Formula: rank = 1 + (current_level - unlock_level) / 100
Maximum: 10 ranks per ability

Examples (Mining Ability 1, unlocks at level 10):
Level 10:   Rank 1
Level 110:  Rank 2
Level 510:  Rank 6
Level 1000: Rank 10 (maximum)
 

Error: "UnsatisfiedLinkError" or "SQLite native library"
Solution:
- Ensure Java 8+ is installed
- Delete old plugin versions
- Restart server completely
- Check console for specific error details
 

Issue: /skills command does nothing
Causes:
1. No permission (mmo.skills.use)
2. Plugin conflict
3. Inventory is full

Solution:
1. Grant permission: /lp user <player> permission set mmo.skills.use true
2. Check for inventory management plugin conflicts
3. Clear inventory space
 

Issue: No XP from actions
Causes:
1. Skill disabled in config
2. Creative mode (ignored by default)
3. Anti-AFK penalty active
4. Event conflicts with other plugins

Solution:
1. Check config: skill-multipliers section
2. Switch to survival mode
3. Wait for AFK penalty to expire
4. Check /skillsadmin debug for event info
 

Issue: High level but abilities still locked
Cause: Data desync between JSON and database

Solution (v1.2.0+):
1. Edit StatsPlayers/<uuid>.json
2. Set ability ranks to 0
3. Restart server
4. Plugin will auto-unlock based on level
5. Check console for "Auto-unlocking" messages