Ignite Crafts - Custom Quest craftings v1.4.0

Every craft is locked behind a quest. Players don't open a menu and buy power - they kill, mine, fish, brew, walk, survive, and the recipe unlocks the moment they finish. The item means something because they worked for it.

And since 1.4.0 you build all of it without touching a config file: click a recipe together in a GUI, install a balanced starter pack with one command, and show every craft off in a polished in-game Codex.

1. Drop the jar in - it's fully standalone, no dependency plugin needed
2. Run /crafts setup - pick Survival, UHC / PvP, Skyblock or RPG and a curated, balanced, fully-wired quest → craft pack installs itself and hot-reloads
3. Type /crafts - your players already have a full progression system in front of them

Packs merge additively - your existing content is never overwritten, conflicts are skipped and reported. A fresh install can even auto-load a starter pack on first run (toggle in config.yml), so the very first /crafts already looks alive.


🛠 GUI Craft Builder - build recipes by clicking, not typing
/crafts editor now creates and edits crafts, not just inspects them:

• Click a live 3×3 grid and place ingredients from a paged material browser - the shaped recipe is captured exactly as placed
• Pick the result material, cycle the action through all 21 built-ins plus your own registered ones
• Step amount, cooldown, charges, coin-cost and the consume toggle - all in the menu
• Save writes straight into crafts.yml and hot-reloads; a bad recipe is rolled back automatically instead of breaking your live config

GUI Quest Builder
The same no-YAML flow for quests: cycle the type (all 42), step the target, and multi-pick reward crafts and prerequisite quests from your existing content. A bad prerequisite chain (cycle or unknown id) is caught and rolled back in place - never at next boot.

Craft Codex - the catalogue your players will screenshot
/crafts codex opens a polished catalogue of every craft:

• Unlocked entries show the real item with a glint; locked ones a silhouette
• Every entry carries a server-wide unlock rate - "owned by 37% of players"
• A rarity tint from common to legendary, driven by how many players actually own it

👁 Action Preview
/crafts preview <craft> fires a craft's action and feedback instantly - no cooldown, no charge, no consume. Feel all 21 actions in two minutes on a test server.

Fully backward compatible: no GUI use is ever required - crafts.yml / quests.yml + /crafts reload still work exactly as before.



What is IgniteCrafts?
IgniteCrafts is a quest-locked custom crafting plugin for Paper and Folia. Instead of giving players every recipe up front, each craft is tied to a quest. Players earn recipes by actually playing - and once a quest is finished, the recipe unlocks instantly and stays unlocked for that player.

They craft from the vanilla table or straight from the in-game unlock menu with the quick craft button. On top of the long-term unlock loop, daily and weekly rotating quests give players a fresh reason to log in every day - an out-of-the-box retention hook with zero code.



How it plays

1. Play naturally - kill, mine, brew, fish, walk, enchant. Everything is tracked in the background
2. Finish the quest - progress is per player. Hit the target and the recipe unlocks instantly
3. Craft and use - craft from the table or the quick craft button. Cooldowns, charges and consume mode are built in
4. Come back tomorrow - daily and weekly rotations roll fresh quests with bonus rewards

Quest Engine - 42 built-in types
Every quest connects directly to a craft unlock. Target, filters, prerequisites and reward crafts are all configured in quests.yml - or clicked together in the GUI Quest Builder.

⚔ Combat
PLAYER_KILL • PLAYER_KILL_STREAK • MOB_KILL • BOW_HIT_PLAYER • PROJECTILE_HIT_PLAYER • PROJECTILE_SHOT • PLAYER_DAMAGE • DAMAGE_TAKEN • PLAYER_HEAL • NEAR_DEATH_HIT

⛏ Blocks & Items
BLOCK_BREAK • BLOCK_PLACE • ITEM_COLLECT • ITEM_CRAFT • ITEM_CONSUME • ITEM_BREAK • FURNACE_EXTRACT • BUCKET_FILL • BUCKET_EMPTY

🏕 Survival & Movement
PLAY_TIME • DISTANCE_WALKED • UNDER_Y_TIME • HIGH_Y_TIME • BIOME_TIME • IN_WATER_TIME • SNEAK_TIME • SPRINT_TIME • WORLD_BORDER_TIME • NEAR_PLAYER_TIME

Utility
BREW_POTION • FISH_CAUGHT • ENCHANT_ITEM • XP_GAIN • ENTITY_TAME • ENTITY_BREED • ADVANCEMENT_DONE • FIND_PLAYER

Custom API
CUSTOM - any external plugin can push its own progress into the quest engine.

Chain them - any quest can list requires to stay frozen until its prerequisites are complete, turning a flat quest list into a real progression tree. Cycles and unknown ids are caught at load.




⚔ Craft Engine & 21 Built-in Actions
Items are defined with a shaped recipe, material, cooldown, charges or consume mode, optional feedback and an action handler - in YAML or fully in-GUI.

UHC / PvP

• POTION_SELF - potion effects to the user
• POTION_TEAM - shares the buff with every alive teammate
• PROJECTILE_DEBUFF - tagged projectile that debuffs on hit
• TRACKER - points to the nearest player
• BRIDGE - short bridge in front of the player
• GLOW_PULSE - briefly glows nearby players
• BLOOD_TOTEM - buffs at the cost of health
• THUNDER_PEARL - pearl with a lightning strike on impact
• INSTANT_WALL - instant 3×3 defensive wall
• TRAP_PROJECTILE - projectile that creates a pit on landing

Universal toolkit

• HARVEST_AREA - harvests every ripe crop around the player
• VEIN_MINER_BURST - breaks a connected ore vein up to a limit
• RECALL - teleport to bed or world spawn
• SUMMON_ALLY - temporary ally entity
• LIFE_STEAL - damage the nearest player and heal the caster
• SHIELD_BUBBLE - resistance + absorption burst
• FORAGE_LOOT - random loot from a configured list

Mobility & utility

• GRAPPLING_HOOK - launch toward your look vector + slow-fall landing
• MAGNET_PULL - vacuum nearby items and XP to the user
• SMOKE_BOMB - blind/slow nearby players, hide the user
• TOTEM_BEACON - regen + resistance aura for everyone in range

Plus NOOP for item-only crafts (enchanted books, gear, loot bundles) that need no right-click effect at all.

Want to feel them all? /crafts preview <craft> fires any action instantly - test all 21 in two minutes.



Charged Crafts & Per-Craft Feedback
Crafted items aren't one-shots - they're tools players manage.

• Add charges: N and the item carries N uses. Each right-click spends one - the count lives on the item, shows in the lore and flashes on the action bar
• on-empty: REMOVE deletes the spent item; KEEP leaves an inert husk you can refill with /crafts recharge
• A feedback block plays a sound, a particle and an action-bar line on every successful use - no custom code needed, typo-safe

Daily & Weekly Rotations - retention out of the box
The rotation engine ships pre-wired in rotations.yml. Pick a pool of existing quests, set how many are active per period, configure the bonus reward.

• Daily and weekly cadence - each rotation rolls fresh picks at its own period flip
• Per-player selection - every player gets their own random pull from the pool
• Bonus rewards on completion - money via Vault and configurable console commands
• Refresh anytime with /crafts rotation

Buy, Pre-Enchant & Team Buffs

• Buy any craft with money - /crafts buy <id> unlocks a craft for cash (Vault or UHC coins) without finishing the quest. Locked items show price + balance + the exact command in their lore
• Pre-enchanted results - add a result-enchantments block and the craft comes already enchanted, including proper enchanted books that anvils accept
• Team-shared buff foods - POTION_TEAM applies the effect to every alive teammate, falling back to a self-buff outside team modes

Developer API
Register your own CraftActionHandler from any plugin and reference it in crafts.yml (or pick it in the GUI builder - registered custom actions appear there automatically). Built-in actions use the exact same path.

• CraftActionHandler - id() key + apply() effect
• CraftActionContext / CraftProjectileHitContext - player, craft, item, projectile, typed settings
• CraftActionValidator - declare required settings, validated at config load
• CUSTOM quest type - push progress into the quest engine from any plugin

Cooldowns, charges, consume mode, feedback and CraftUseEvent are handled by the dispatcher automatically. Your handler stays focused on the effect only.



Integrations & Storage

• PlaceholderAPI - full expansion registered automatically when present
• Vault - money cost to buy crafts, money rewards on quest complete, rotation bonus
• MythicMobs - filter MOB_KILL quests with MYTHIC:<mob_id>
• IgniteUHC - tighter match lifecycle + UHC-coin economy for UHC servers

Every integration is soft-loaded - missing plugins are skipped silently.

Storage: YAML (default, zero-config) • SQLite (drop-in file database) • MySQL (cross-server progress for BungeeCord / Velocity networks). HikariCP pooling and JDBC drivers load automatically through Paper's library loader.




🖥 Player GUI & Admin Tools
A paginated unlock menu lists every craft - locked recipes as a block icon, unlocked ones as the real item. Click any entry for the recipe screen with the shaped 3×3 grid and a quick craft button. Progress bars, lore templates, slots, fillers and buttons are all configurable.

/crafts codex - the polished player-facing catalogue with unlock rates and rarity tints.
/crafts editor - the full admin builder: create, edit and delete crafts and quests entirely in-game.
/crafts setup - the pack wizard: Survival, UHC / PvP, Skyblock or RPG, installed in one click.



⌨ Commands

Players

• /crafts - open the craft unlock menu
• /crafts codex - open the Craft Codex catalogue
• /crafts buy <craft> - unlock a craft for money / coins
• /crafts stats [player] - crafts unlocked + quests completed
• /crafts rotation - view & refresh daily and weekly rotations

Admins

• /crafts editor - create, edit and delete crafts & quests in-GUI
• /crafts setup [pack] - install a preset pack (wizard or direct)
• /crafts preview <craft> - fire any craft's action instantly
• /crafts give <player> <craft> [amount] - give a craft item
• /crafts unlock <player> <craft> - force-unlock a recipe
• /crafts recharge <player> <craft> - refill a charged item
• /crafts reset <player> - reset all progress
• /crafts reload - reload all configuration

Main command: /ignitecrafts Alias: /crafts




Requirements

• Paper or Folia: 1.21+
• Java: 21
• Optional: PlaceholderAPI, Vault + economy provider, MythicMobs, IgniteUHC

Standalone JAR - IgniteAPI and ACF are shaded and relocated inside the jar. JDBC drivers are pulled at runtime by Paper's library loader. No separate dependency plugin needed.



Perfect For

• Survival, SMP and Lifesteal servers that want a progression hook
• UHC, PvP and hardcore event servers
• Skyblock and RPG-style servers
• Servers with custom items or unique item economies
• Developers building progression systems on the custom action API
• Anyone who wants a quest-locked crafting system without writing YAML

IgniteCrafts is a long-term project - four major updates shipped already, each one free for existing buyers. The roadmap keeps going: more preset packs, more actions, deeper Codex features and community-requested quest types.



Changelog