CrystalHit's

CrystalHit's is a competitive Crystal PvP hit registration and combat lag optimization plugin designed to deliver the crisp, instantaneous combat feel found on top-tier practice networks like mcpvp.club and stray.gg.

Say goodbye to delayed crystal explosions, ghost hitboxes, sluggish crossbow shots, and client FPS drops during high-CPS crystal battles.

---

⚡ Key Features

🔮 0-Tick Instant Crystal Break

• Zero-Tick Detonation: Crystals detonate the exact millisecond they take damage or are clicked—no vanilla tick delays or death animation latency.
• Ghost Crystal Prevention: Dead crystal entities are cleared instantly from the world and client view, ensuring you can immediately place and hit your next crystal without hitting an invisible hitbox.
• Fast-Place Validation: Rapid placement checks on obsidian and bedrock support sustained 20+ CPS crystal combat.
• Customizable Explosion Physics: Adjust explosion power, toggle terrain block damage, and disable fire creation for cleaner, lag-free arenas.

---

🎯 Responsive Hit Registration (mcpvp.club Style)

• Tuned NoDamageTicks: Replaces the sluggish vanilla 20-tick (1.0s) invulnerability window with a competitive 10-tick (0.5s) standard (or whatever you configure), allowing fast hit combos to register cleanly.
• Attack Cooldown Override (Optional): Bypass 1.9+ attack cooldowns or tune attack speed for responsive, spam-friendly melee.
• Crisp Hit Feedback: Satisfying ding sound cues (ENTITY_EXPERIENCE_ORB_PICKUP) on successful player and crystal hits.

---

🏹 Crossbow & Projectile Hit Booster

• Velocity Multiplier: Accelerates crossbow arrows and firework rockets (default 1.25x) so your shots connect faster and track opponents accurately.
• Instant Projectile Damage: Bypasses invulnerability frames upon projectile impact to guarantee immediate damage registration.
• Quick Charge Synchronization: Eliminates client-server desync during rapid crossbow loading and firing.
• Consistent Knockback: Delivers smooth, predictable projectile knockback.

---

⚓ High-Speed Respawn Anchors

• Fast Glowstone Charging: Instantly charges Respawn Anchors on right-click without click delays.
• 0-Tick Anchor Detonation: Triggers immediate anchor explosions in non-Nether dimensions and removes the anchor block instantly to prevent ghost blocks.

---

🛡️ Built-in FPS & Server TPS Optimizer

• Explosion Particle Culler: Replaces vanilla's heavy smoke mushroom clouds (EXPLOSION_EMITTER) with clean, lightweight explosion particles to stop client FPS drops during intense crystal spam.
• Dead Arrow Auto-Cleaner: Automatically removes arrows embedded in blocks or the ground after a short configurable delay.
• Smart TPS Guard: Dynamically throttles heavy calculations if TPS drops below your configured threshold (e.g., 18.0), keeping the game smooth.
• Per-Player Toggle: Players can toggle the optimizer on or off individually using /ch toggle.

---

🔔 Competitive Totem Pop Counter

• Tracks active totem pops in real-time during fights.
• Displays live pop notifications directly in the actionbar and chat.
• Plays clear totem pop audio feedback.

---

💻 Commands & Permissions

Commands

• /ch help - Displays the help menu and plugin information.
• /ch toggle - Toggles personal optimizer mode on or off.
• /ch stats - Displays your current ping, server TPS, and totem pop statistics.
• /ch reload - Reloads config.yml (Requires admin permission).

Permissions

• crystalhits.use - Allows players to use /ch help, /ch toggle, and /ch stats (Default: Everyone).
• crystalhits.admin - Allows administrators to use /ch reload (Default: OP).

---

⚙️ Configuration Preview

crystal-optimizer:
  instant-break: true
  remove-entity-immediately: true
  explosion-power: 6.0
  create-fire: false
  block-damage: false
  fast-crystal-place: true

hit-system:
  enabled: true
  custom-no-damage-ticks: 10
  override-attack-cooldown: false
  ding-on-hit: true

crossbow-optimizer:
  enabled: true
  projectile-velocity-multiplier: 1.25
  instant-hit-registration: true

performance-optimizer:
  enabled: true
  optimize-explosion-particles: true
  clean-arrows: true
  anti-tps-drop: true