🛠️ Administrative Improvements

Admin Inspect Command (/curios inspect)

• NEW: Added /curios inspect <player> [slot] to inspect and manage other players' accessories (works for both online and offline players).
• If no slot is specified, it opens a read-only Overview GUI showcasing all equipped slots and their item counts. Admins can click a slot button to open the detailed slot GUI.
• If a slot is specified, opens a Slot Detail GUI where admins can add, remove, or swap accessories directly. Saving automatically invokes equip events and updates 3D models for online players.
• Requires curiospaper.admin permission.

Custom NBT & Enchants Editor GUI

• NEW: Added an NBT & Enchants Editor button (Command Block) in the main Custom Item Editor (slot 21).
• Manage NBT (PDC Keys): Interactively add or delete custom NBT tags stored in the item's Persistent Data Container (PDC) via simple chat input (key = type:value, e.g., myplugin:power = int:42).
• NBT Key Suggester: Browse and select existing NBT keys from standard Minecraft data components, other custom items, or the admin's inventory.
• Supported PDC types: string, int, double, float, byte, short, long.
• Manage Enchantments: Add or remove enchantments on the custom item with configurable levels.
• Hide Enchantments: Toggle whether enchantment tooltips are hidden from lore (glint only) via ItemFlag.HIDE_ENCHANTS.
• Unbreakable Toggle: Easily make the custom item unbreakable.
• Placeable Toggle: Prevent players from placing custom blocks or custom player heads on the ground (cancelled via BlockPlaceEvent).

📦 Compatibility & Networking

Random Teleport (RTP) Compatibility / Dismount System

• NEW: Added a temporary dismount mechanism to resolve passenger teleportation failures during random teleports (RTP) or portal transitions.
• RTP Command Recording: Interactively record sequences (commands, stepped-on blocks, clicked levers/buttons, entity/NPC clicks, and GUI clicks) using /curios recordrtp.
• When a player triggers an RTP interaction, their 3D model armor stands are temporarily dismounted. Once the teleport completes and the player moves again, the armor stands are seamlessly remounted at the destination.
• Configurable under features.rtp in config.yml. Can be disabled entirely via features.rtp.enabled: false.

Resource Pack Hosting Modes

• NEW: Added resource-pack.mode setting supporting three hosting modes:
  • SELF — Host the pack locally on the Minecraft server using the built-in Netty HTTP server.
  • LINK — Provide a direct download link (resource-pack.url) for external hosting.
  • NONE — Completely disable automatic resource pack hosting/delivery.
• Query Parameter Cache-Busting: On player join, the resource pack URL is automatically appended with ?v=<hash> (or &v=<hash> if a query string already exists) to bust the client cache and force the Minecraft client to redownload the resource pack when it is updated.

🧪 Crafting & Recipe Logic

Strict Crafting with ExactChoice

• Upgraded custom recipe ingredient resolution to use RecipeChoice.ExactChoice for shaped, furnace, smoker, blasting, campfire, smithing, and shapeless recipes (if supported by server).
• This ensures recipes strictly require the exact custom Curios item instead of just any item matching the base material.
• Added strict crafting protection: custom Curios items can no longer be used in vanilla recipes (clears craft results or cancels CraftItemEvent/PrepareItemCraftEvent).

⚡ Performance & API Enhancements

Ability Modifier Reconciliation Task

• NEW: Added a background task (ModifierReconciliationTask) that runs every 5 seconds to automatically detect and remove orphaned/stale attribute modifiers from players.
• Fully strips all CuriosPaper-related modifiers (curiospaper_ability_) from players on plugin shutdown/reload to prevent persistent attributes across reloads.
• Upgraded item ID lookup in AbilityListener to prioritize PDC metadata (curiospaper:item_id) over display name lookup, making tracking much more robust.

Custom PLAYER_HEAD Skin Support

• NEW: Setting item-model to a base64 skin texture or skin URL on a PLAYER_HEAD custom item now automatically downloads and applies the texture using reflection (supporting 1.14-1.21+).
• Added ItemStack createBase64Skull(String base64) to CuriosPaperAPI for developers to programmatically create player heads with custom skins.

🛠️ Administrative Improvements

Consolidated Command System

• NEW: The /edit command has been merged into /curios for a more unified administrative experience.
• All management actions are now subcommands of /curios:
  • /curios list — Opens the new Paginated Item Browser
  • /curios create <id> — Create a new custom item
  • /curios edit <id> — Open the editor for an existing item
  • /curios delete <id> — Delete a custom item
  • /curios give <id> [player] [amount] — Distribute custom items
  • /curios reload — Reload configuration and messages
• Command aliases updated: /cp, /curiospaper.
• Permission node curiospaper.edit has been merged into curiospaper.admin.

Paginated Item Browser (ItemListGUI)

• NEW: A dedicated GUI to browse all custom items in a paginated view.
• Supports left-click to view item recipes and right-click to jump directly into the item editor.
• Navigation buttons for previous/next pages and a close button.

Localization & Messaging (MessagesManager)

• NEW: Added messages.yml for full customization of all plugin messages and GUI titles.
• Supports Hex colors and legacy color codes.
• Messages can be reloaded on the fly using /curios reload.

Auto-Update Checker (UpdateChecker)

• NEW: Built-in update checker that notifies administrators of new releases on startup and login.
• Can be toggled in config.yml.

✨ API & Event Enhancements

New Events

• NEW: CuriosCraftEvent — Fired when a custom item is created via crafting, smelting, smithing, or anvil repair. Allows final modification of the result item.
• NEW: CuriosModelEquipEvent — Fired when a 3D model is about to be displayed on a player. Allows modifying the model material, CMD, or item model on the fly.
• NEW: CuriosMobModelEquipEvent — Fired when a 3D model is about to be displayed on a mob.

API Improvements

• Added CuriosPaperAPI#reload() to trigger a full plugin reload from other plugins.
• Enhanced ItemData with visibility flags to support hidden items in the browser.

⚙️ Configuration Changes

New Config File: messages.yml

• Contains all user-facing strings, categorized by system (commands, GUI, errors, etc.).

Updated config.yml

• Added features.update-checker toggle.
• Removed hardcoded message strings (moved to messages.yml).

🐛 Bug Fixes & Refinement

• Fixed an issue where the Elytra model would occasionally fail to sync after teleportation.
• Improved ModelStandManager performance during high-frequency movement.
• Standardized all GUI titles to use the new messaging system.
• Refactored CuriosCommand to handle the expanded subcommand set with better tab-completion.

---

---

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

---

v1.1.0 — Major Rewrite & Feature Expansion

This update completely transforms CuriosPaper into a full in-game custom item creation framework — no more manual configs, no more external editors. Everything can now be created, edited, and managed directly inside the game.

---

⭐ Major Additions

✔ Full In-Game Custom Item Editor

A complete GUI-driven system for creating and editing custom items:

• Set name, material, slot type, model
• Edit lore
• Real-time item previews
• Save or cancel changes safely

✔ New Data Systems

New modular data models powering the editor:

• ItemData – Core container for everything about a custom item
• RecipeData – Shaped & shapeless recipes
• LootTableData – Chest loot integration
• MobDropData – Entity drop configuration
• VillagerTradeData – Profession & level-based trading
• AbilityData – Triggers & effects for equipped items

---

⭐ New Editors / GUIs

Item Editing System

• EditGUI — Central editor hub
• RecipeEditorGUI — Drag-and-drop recipe builder
• LootTableBrowser — Browse, add, and configure loot sources
• MobDropEditor — Configure drops for every entity type
• TradeEditor — Build villager trades with full control
• AbilityEditorGUI — Add potion effects or attribute modifiers with EQUIP/UNEQUIP/WHILE_EQUIPPED triggers

---

⭐ New Gameplay Systems

Ability System

Items can now apply:

• Potion effects
• Attribute modifiers (health, armor, speed, etc.)

Full trigger support:

• EQUIP
• DE_EQUIP
• WHILE_EQUIPPED (auto-refreshing every second)

Loot Table Injection

• Works with all vanilla & custom tables
• Smart matching ("dungeon" → all dungeon loot)
• Fully configurable chance & amount

Mob Drop System

• Supports all mobs
• Chance, min/max amounts
• Looting enchantment support

Villager Trade System

• Profession & level filtering
• Wandering trader support
• 1–2 cost items
• Prevents duplicate trades

---

⭐ API Expansion

CuriosPaperAPI now includes:

Item Management

• getItemData(id)
• createItem(id)
• saveItemData(id)
• deleteItem(id)

Integration Registration

• registerItemRecipe
• registerItemLootTable
• registerItemMobDrop
• registerItemVillagerTrade

Accessory Utilities

• Tagging & validation for accessory slot types

---

⭐ Improved Infrastructure

• Better error handling & validation
• Improved CustomModelData + NamespacedKey model support
• Cleanup tasks on plugin shutdown
• New event listeners for abilities, recipes, mob drops, trades

---

🐛 Fixes & Stability Improvements

• More reliable accessory slot tagging
• Fixed duplicate registrations for trades/drops/loot
• Better debug logging across all systems
• File saving/loading is now far more robust

---

📁 File System Changes

• All custom items now stored cleanly in /items/
• Automatic serialization via YAML
• No breaking changes — older setups continue to work

---

🚀 Major Resource Pack System Overhaul

The entire resource pack pipeline has been redesigned for stability, performance, and extensibility.

✔ Dirty-Flag Build System

• Pack now builds only once after plugins finish registering.
• No more multiple rebuilds spamming your server startup.
• /curios rp rebuild forces a rebuild when needed.

✔ Proper Namespace Enforcement

• Reserved namespace curiospaper is now locked. Only CuriosPaper itself can use it.
• Addons attempting to use it are rejected (no crashes).
• Minecraft namespace (minecraft:) is only allowed when enabled in config.

✔ Namespace Conflict Logging

New conflict categories are now visible via:

/curios rp conflicts

Logs include:

• Reserved namespace violations
• Minecraft namespace violations
• Duplicate namespace owners
• Allowed (config-enabled) conflicts

✔ File Conflict Handling

• Only curated files support JSON merging:

  • curios_item_base.json
  • curios_combined_override.json

• All other files use strict copy-or-skip logic.

• Conflicting files are logged cleanly without stopping the build.

---

📦 Resource Pack Delivery Improvements

• Rebuilds now automatically re-send the updated pack to all online players.
• Clients receive the correct updated assets without needing to relog.
• Pack SHA1 hash is recalculated and applied correctly.

---

🛠 New Admin Commands

/curios rp info

Shows:

• RP server status
• Host + port
• Pack size
• Hash
• Dirty state
• Registered namespaces
• Registered sources

/curios rp rebuild

• Forces full rebuild
• Sends the updated pack to all online players

/curios rp conflicts

• Shows namespace + file conflicts in one place

---

🐛 Fixes

• Plugin no longer crashes when addons misuse namespaces.
• CuriosPaper no longer blocks itself from using curiospaper or minecraft.
• Rebuild now correctly refreshes the pack for all players.
• Removed unsafe deep JSON merging everywhere except curated overrides.

---

❤️ Developer Improvements

• Added new getters for debugging and integration.
• Enforced consistent namespace ownership model.
• Simplified addon RP registration behavior.
• Removed fragile merging code in favor of predictable behavior.

---

🎉 Update Summary

CuriosPaper v1.0.2 is a massive stability overhaul, especially in how resource packs are validated, built, and distributed. Addons are now safer, conflicts are predictable, and server owners have better control + visibility.

---

Added Elytra support for the back slot

now you can use the elytra and your chestplate at the same time enable this in the config