---

CuriosPaper v1.3.0

Release Date: 2026-04-27

✨ New Features

• 3D Model System — Accessories now render as 3D models on players using invisible armor stands. Supports sneaking, swimming, gliding, scaling, and trident compatibility. Players can toggle visibility per-item.
• Quick Equip — Shift + Right-Click to instantly equip accessories into the first available slot.
• Accessory Hotkey — Configurable sneak-based hotkey to open the accessory GUI (single, double, or hold sneak modes).
• Keep Curio Inventory on Death — Three modes: Always, Auto (follows keepInventory gamerule), or Never.
• Loot Table Editor GUI — Complete 3-screen rewrite with browsing, filtering, and quick config presets.
• 3D Model Config GUIs — In-game editors for item and mob drop 3D model settings.
• Custom Events — CuriosLootGenerateEvent and CuriosMobDropEvent for intercepting and modifying generated items.

🔧 API Additions

• countEquippedItems, unregisterSlot, registerItemRecipe, registerItemLootTable, registerItemMobDrop, registerItemVillagerTrade
• getItemData, createItem, saveItemData, deleteItem
• setItemModelConfig, setMobDropModelConfig
• registerResourcePackAssets, registerResourcePackAssetsFromJar
• New/updated data classes: LootTableData, MobDropData, ItemData

⚙️ Configuration

• New: features.hotkey, features.keep-curio-inventory, resource-pack.combine-external-rp
• Simplified slot display names (removed decorative Unicode)
• GUI size is now auto-calculated (gui.main-slots and gui.main-layout removed)

🐛 Fixes & Improvements

• Improved loot table injection and mob drop logic
• Better external resource pack combining
• Codebase reformatted to 2-space indentation

---

Critical bug Fixes

• fixed smithing table recipe related bugs
• fixed the broken resource pack pipeline
• fixed a error in the api
• optimized the plugin for better performance

---

• Added support for MC version 1.14 to 1.21
• Works with spigot, paper, and purpur
• Added a new /curios editmenu command to rearrange the bbag menu as you wish
• Updated the documentation with latest info
• Minor API changes you can check the documentation for it
• Minor bug fixes report by our respected Discord members

---

✅ CuriosPaper v1.1.2 – Bug Fix Update

Fixed

• 🛠️ Resolved issues in the recipe system that could cause incorrect behavior or failures.
• 🪂 Fixed bugs in the Elytra back slot system to ensure proper equipping and functionality.

Credits Huge thanks to Vague Ideas for reporting these bugs and helping improve the plugin. Your feedback directly made this update possible. 🙌

Help Improve CuriosPaper If you find any bugs, weird behavior, or have feature suggestions, join the Discord and report them. The faster issues are reported, the faster they get fixed.

👉 Join the Discord & help make CuriosPaper better.

---

CuriosPaper v1.1.1 — Advanced Recipe System & API Expansion

This update expands CuriosPaper beyond basic crafting by introducing full vanilla recipe support, safer item upgrades, and tighter server control over in-game editors.

---

🚀 Major Features

Expanded Recipe System

CuriosPaper now supports non-crafting recipe mechanics, enabling real progression and upgrade systems.

New supported recipe types:

• FURNACE — Smelting with configurable time & XP
• BLAST_FURNACE — Fast smelting
• SMOKER — Food cooking
• ANVIL — Item combination & upgrade recipes with XP cost
• SMITHING — Base / addition / template based upgrades

This unlocks:

• Tiered item upgrades
• Anvil-based enhancements
• Smithing-table item evolution
• Smelting-based custom materials

---

NEW: CuriosRecipeTransferEvent

A new cancelable event fired whenever CuriosPaper transfers custom item data during any recipe operation.

Purpose: Vanilla recipes normally discard custom metadata. This event gives addons full control over how data moves from source → result.

Key points:

• Fires for ALL recipe types
• Provides source and result ItemStack
• Allows safe upgrades (e.g. backpack tiers)
• Can cancel crafting if transfer fails

---

🔧 API Enhancements

RecipeData Expansion

RecipeData now supports all recipe types with strict validation.

New fields include:

Furnace / Smoker / Blast Furnace

• inputItem
• cookingTime (ticks, default 200)
• experience

Anvil

• leftInput
• rightInput
• experience (XP cost)

Smithing

• baseItem
• additionItem
• templateItem (optional, version-safe)

Validation

• isValid() now validates per recipe type
• Prevents invalid or partial registrations

---

CuriosPaperAPI Improvements

• New registration methods for all recipe types
• Stronger validation & error feedback
• Automatic integration with CuriosRecipeTransferEvent
• Safer addon-facing API boundaries

---

⚙ Configuration Changes

Item Editor Toggle (NEW)

A new config option allows server owners to completely disable all in-game item editors.

item-editor:
  enabled: true

When set to false:

• /edit and related item editor commands are disabled
• All item editor GUIs are blocked
• API functionality remains fully usable for addons
• Ideal for production servers that only want addon-defined items

---

🧰 Commands & Permissions

Commands

• /edit

  • Alias: itemedit
  • Opens the in-game item editor (if enabled)

Permissions

• curiospaper.admin — Full admin access
• curiospaper.edit — Item editor access (default: OP)

---

🛠 Internal Improvements

RecipeListener (Refactored)

• Unified handling for all recipe types
• Reliable data transfer pipeline
• Safer failure handling (no silent corruption)
• Faster recipe lookups

RecipeEditorGUI

• Support for all new recipe types
• Furnace time & XP configuration
• Anvil input & XP cost handling
• Smithing base/addition/template UI
• Improved validation feedback

ItemDataManager

• Improved serialization & deserialization
• More reliable autosave logic
• Better external plugin compatibility

---

🐛 Fixes & Stability

• Fixed recipe data persistence issues
• Fixed edge cases in recipe validation
• Improved slot manager stability
• More reliable autosave behavior

---

⚡ Performance Improvements

• Faster recipe lookup & caching
• Optimized inventory event handling
• Reduced memory footprint for recipe data
• Improved async save operations

---

🔄 Compatibility

• Fully backward compatible with v1.1.0
• Existing SHAPED & SHAPELESS recipes continue to work
• No migration required
• Addons automatically benefit from new recipe handling

---

🧭 Addon Developer Notes

• CuriosRecipeTransferEvent now fires for all recipe types
• Use event.getRecipeType() if logic differs per recipe
• Source & result items are always initialized

---