Features

LancerCore turns the vanilla Spear into a deadly, skill-based weapon. It introduces a combo system, visual effects, and advanced damage calculations based on speed and mounts.

• Grappling Trident (v4.0 NEW!):
  Experience unparalleled 3D mobility! You MUST equip a Lead in your off-hand and throw a Trident to anchor it to any surface. Right-click to pull yourself towards it. Hook distance scales with the Unbreaking enchantment!
• The Catalyst System (v4.1 & v4.2 NEW!):
  Hold specific items in your off-hand while striking with the spear to trigger powerful magical effects!
  • Name Tag (Marked): Reveals hidden enemies globally for 15s.
  • Magma Cream (Lava Trail): Target leaves a trail of fire when moving.
  • Nether Star (Gravity Well): Pulls all nearby enemies toward your target.
  • Totem of Undying (False Death): Grants 2s of invisibility + invulnerability.
  • Heart of the Sea (Tidal Pull): Drags the target forcefully toward you.
  • Prismarine Shard (Mirror Shield): Reflects 100% of the next attack received.
  • Prismarine Crystals (Refraction): Reduces incoming damage by 40% and reflects it back for 4s.
  • Nether Wart (Blood Curse): Target damages themselves every time they hit you for 4s.
• Advanced Damage Scaling:
  Configurable damage multipliers. Deal massive damage while riding horses, pigs, or camels with the Cavalry Bonus.
• Combo System:
  Chain attacks to build up your combo meter. Displays an animated Action Bar message and plays rising pitch sounds for satisfaction (Devil May Cry style!).
• Visual Effects:
  Unlock particle auras (Helix or Circle) when reaching high combos. Fully configurable particle types (Soul Fire, Flame, Redstone, etc.).
• Ghost Reach:
  Perform long-range attacks when your combo is high.
• Bleeding & Lightning:
  Enemies bleed on impact and lightning strikes on high combos.
• Balanced Mechanics:
  Add a configurable Hunger Cost to the Spear's "Lunge" attack to prevent spamming.
• Database & Stats:
  Built-in SQLite database to track Kills, Max Combos, and records without lag.
• PlaceholderAPI Support:
  Display stats on your Scoreboard or Tablist easily.

🔮 Visual Showcase

🚀 NEW: Grappling Trident Mobility
Anchor to blocks and pull yourself through the air!

Customize your experience with the /lc particles menu. Choose your style and particle type!

Soul Fire Particle

Helix Style | Aura Style

Click to view GIFs

Dark Magic (Witch)

Helix Style | Aura Style

Click to view GIFs

Redstone (Dust)

Helix Style | Aura Style

Click to view GIFs

Flame

Helix Style | Aura Style

Click to view GIFs

Totem

Helix Style | Aura Style

Click to view GIFs

⚔️ Combat Gameplay

(The damage can be configured)

⚙️ Commands & Permissions

• /lc reload - Reloads the configuration file.
  Permission: lancercore.admin
• /lc particles - Opens the particle customization menu.
  Permission: lancercore.particles.all (or specific nodes)

📊 Placeholders (PAPI)

LancerCore includes native PlaceholderAPI hook (no extra download needed).

• %lancercore_combo% - Shows current active combo.
• %lancercore_kills% - Shows total spear kills.
• %lancercore_max_combo% - Shows the player's highest combo record.

🛠️ Configuration

The config is 100% customizable and commented for ease of use.

# ==========================================
#         LancerCore Configuration
# ==========================================

prefix: "&8[&bLancerCore&8] "

combat:
  damage-multiplier: 1.5
  mount-bonus-multiplier: 2.0
  lunge-hunger-cost: 2
  bleeding:
    enabled: true
    chance: 0.25
  ghost-reach:
    enabled: true
    range: 7.0

combo:
  enabled: true
  reset-time-seconds: 5
  sounds:
    enabled: true
    hit-sound: "BLOCK_NOTE_BLOCK_PLING"
  finisher:
    enabled: true
    sound: "ENTITY_WITHER_SPAWN"
    min-combo-trigger: 5

visuals:
  action-bar: true
  combo-message: "&6&lLANCE COMBO &e&lx{combo}"
  lightning:
    enabled: true
  particles:
    enabled: true
    style: "HELIX"
    default-type: "SOUL_FIRE_FLAME"
    min-combo-trigger: 3
    radius: 1.2

storage:
  type: "SQLITE"

# ==========================================
#         GRAPPLING TRIDENT SYSTEM
# ==========================================
grappling-trident:
  enabled: true
  require-lead-in-offhand: true
  cooldown-seconds: 5
  fall-immunity-seconds: 8
  pull-speed-multiplier: 1.8
  ranges:
    base: 15
    unbreaking-1: 25
    unbreaking-2: 35
    unbreaking-3: 50
  messages:
    out-of-range: "&c&lTarget too far! &8(Max: {max}m)"
    on-cooldown: "&e&lGrapple on cooldown! &8({time}s)"
    anchored: "&a&lAnchored! &7Right-click to pull."

# ==========================================
#             CATALYST SYSTEM
# ==========================================
catalysts:
  name-tag:
    enabled: true
    consume-item: true
    duration-seconds: 15
  magma-cream:
    enabled: true
    consume-item: true
    duration-seconds: 4
  nether-star:
    enabled: true
    consume-item: true
    radius: 8.0
    duration-seconds: 2
  totem:
    enabled: true
    consume-item: false
    duration-seconds: 2
    cooldown-seconds: 60
  heart-of-the-sea:
    enabled: true
    consume-item: true
    pull-strength: 2.0
  prismarine-shard:
    enabled: true
    consume-item: true
    duration-seconds: 5
  prismarine-crystals:
    enabled: true
    consume-item: true
    duration-seconds: 4
    reflect-percentage: 0.4
  nether-wart:
    enabled: true
    consume-item: true
    duration-seconds: 4