✨ RareItemHunter [Remaster] ✨ HIGHLY CONFIGURABLE | PERMISSIONS | CUSTOM BOSSES | EASY SETUP

Bring legendary boss encounters to your Spigot/Paper server. Bosses spawn as hidden eggs scattered across the world. Players must track them down, awaken them, survive the fight, and claim rare materials to forge powerful custom items.

• Legendary Bosses - Ships with 23 preconfigured boss definitions, all fully customizable with custom HP, armor, weapons, skills, and drop tables. Build encounters using supported vanilla living entity types.
• 30+ Boss Skills - Pull, Disarm, Disorient, LightningStorm, PoisonDart, Blink, JumpAttack, and more. Configure skill chances and HP-based events to shape each encounter.
• Boss Events - Define phase transitions: when the boss drops below a certain HP, trigger a new skill, spawn reinforcements, or escalate the fight.
• Egg Hunt System - Bosses spawn as eggs hidden in the world. Players use a Legendary Compass to track them down before they disappear.
• Two Legendary Compasses - Track boss eggs with the standard compass, or use the enhanced version for distance feedback. Both have configurable crafting recipes.
• Rare Item Crafting - Defeating bosses drops crafting materials (Rare Essences, Dark Matter, Cursed Diamonds, Legendary Tributes). Players combine them to craft items with unique active and passive properties.
• Region-Based Property Rules - Fully configurable region_rules.yml support lets you block or allow specific properties, spells, skills, and types in selected WorldGuard regions.
• 32 Custom Properties - Fly, Invisibility, Vampiric Regeneration, Burst, GreaterBurst, Confuse, Slow, Haste, Backstab, Repair Item, and more. Configure property level limits, activation costs and component recipes.
• Three Cost Systems - Properties consume food, XP, or money (EssentialsX) when activated.
• Player and Clan Statistics - Track kills, damage dealt, boss deaths, eggs opened, and more. Stored in YAML or MySQL. Expose supported statistics via PlaceholderAPI for external scoreboards and holograms.
• Anti-Logout Protection - CombatLogX integration can tag players in combat during boss fights and lets you block specific properties while tagged.
• WorldGuard Region Control - Restrict random egg spawning to specific regions per world and control property usage with per-region rules in region_rules.yml.
• Regional Spawn Pools - Reusable weighted boss pools, global or per-region timers, spawn chances, overlap priorities and encounter limits.
• Persistent Encounters - Saves active boss state and egg expiration across normal restarts, with boss recovery when chunks load.
• Configurable Boss AI - Choose legacy behavior or V2 target selection based on threat and distance, globally or per boss.
• Clan and Faction Support - Optional group information and clan boss-kill statistics through supported providers (CubeClans, SimpleClans, ImprovedFactions, FactionsUUID, Saber-Factions).
• Custom Presentation - English and Spanish messages, world aliases, boss names, boss bars, sounds, titles and chat notifications.
• Terrain Controls - Configure where boss explosions and projectiles may damage blocks.
• No Restart Required - Config changes apply instantly with /rih reload.

1. The plugin periodically attempts to spawn a boss egg in the world.
2. Players with the rareitemhunter.hunter.compass permission use a Legendary Compass to locate the egg before it expires.
3. A player who gets close enough awakens the egg into a Legendary Boss.
4. Defeating the boss drops rare materials used to craft Rare Items.

• Paper/Spigot 1.21.x
• Tested on 1.21.11, 26.1, 26.2
• Java 21

• EssentialsX - Enables money as a property cost type and god-mode disabling on boss fight.
• WorldGuard + WorldEdit - Restricts boss egg spawning to specific regions per world and enables property region rules via region_rules.yml. Also required for regional spawn pools.
• PlaceholderAPI - Exposes server and player stats as placeholders for scoreboards, holograms, etc.
• CombatLogX - Can tag players in combat when fighting bosses and optionally block specific properties during combat.

These integrations are optional for the core plugin. Regional spawn pools require WorldGuard and its WorldEdit dependency. If enabled pool configuration is invalid or WorldGuard is unavailable, automatic pool spawning stops instead of falling back to unrestricted spawning.

1. Drop the latest RIH-Remaster-(1.21.x)-vX.Y.Z.jar into your plugins/ folder.
2. Start the server. The plugin generates its config files.
3. Edit plugins/RIH-Remaster/config.yml, bosses.yml and rares.yml. Configure spawn_pools.yml for regional spawning, region_rules.yml for property restrictions, and world_aliases.yml for world display names.
4. Automatic spawning is disabled in the shipped configuration. Enable regional pools or set a positive trySpawnBossMinutes for legacy automatic spawning.
5. Use /rih reload to apply config changes without restarting.

Full step-by-step setup, every config key and admin command are documented at rareitemhunter.gitbook.io.