What is CuriosPaper?

CuriosPaper adds a complete accessory slot system to your Minecraft server. Players can equip rings, necklaces, capes, belts, charms, and more through a clean, tiered GUI — no client mods required.



⚡ Features

Core Accessory System
• 9 Slot Types — Head, Necklace, Back, Body, Belt, Hands, Bracelet, Ring, Charm
• Ability System — Potion effects & attribute modifiers that activate when equipped
• Quick Equip — Shift + Right-Click to instantly equip accessories from your hand
• Hotkey System — Configurable sneak keybind to open the accessory GUI — no commands needed
• Elytra Back Slot — Equip elytra in the back accessory slot (1.21.3+)
• Death Behavior — Keep, drop, or auto-detect accessories on death — fully configurable

3D Model System [SUP]NEW in v1.3.0[/SUP]
Attach custom 3D models directly to the player's body when accessories are equipped. Models are rendered using synchronized invisible armor stands — visible to all nearby players.
• Tracks player movement, rotation, sneaking, swimming, and flying
• Smart visibility culling — hide models from the wearer's first-person view
• Trident compatibility — models auto-hide during throws and riptide
• Mob models — mobs can visually wear items they'll drop
• Per-item toggle — players can right-click to show/hide their models

️ In-Game GUI Editors
Create and configure everything visually — no YAML editing required:
• Item Editor — Set name, material, lore, model data, slot type
• Ability Editor — Configure potion effects & attribute modifiers with triggers
• Recipe Editor — Shaped, shapeless, furnace, blast, smoker, anvil & smithing recipes
• Loot Table Editor — Browse all server loot tables, add items to dungeon chests with presets
• Mob Drop Editor — Configure which mobs drop your items and at what chance
• Trade Editor — Set up villager trades with professions and price ranges
• 3D Model Editor — Configure body-mounted 3D models with pitch limits


Item Distribution
• Crafting Recipes — 7 recipe types (shaped, shapeless, furnace, blast, smoker, anvil, smithing)
• Loot Tables — Items appear in dungeon chests, mineshafts, temples, strongholds, and more
• Mob Drops — Any mob type can drop accessories with configurable chance & amount
• Villager Trades — Accessories appear in villager trade pools by profession and level
• Commands — /curios give <item> [player] [amount] for direct distribution

Developer API
A comprehensive API for other plugins to integrate with CuriosPaper. Tag any item as an accessory, check what a player is wearing, register slots, items, recipes, loot tables at runtime, and contribute resource pack assets directly from your plugin's JAR.

Custom Events:
• AccessoryEquipEvent
• CuriosLootGenerateEvent
• CuriosMobDropEvent
• CuriosRecipeTransferEvent
• CuriosCraftEvent
• CuriosModelEquipEvent
• CuriosMobModelEquipEvent


How It Works

1. /baubles → Opens the accessory menu
2. Click a slot icon → Opens that slot's inventory
3. Place an accessory → Abilities activate instantly!

Or use Quick Equip: Hold a tagged item + Shift + Right-Click to equip instantly.
Or use the Hotkey: Select a hotbar slot + Double-Sneak to open the menu.


Stats



Compatibility

• Minecraft: 1.14.4 — 1.21+
• Server: Spigot, Paper, Purpur, Folia*
• Java: 8+
• Dependencies: None (standalone)

*Folia support is experimental


Quick Start

1. Download CuriosPaper.jar from Modrinth or GitHub Releases
2. Drop it into your server's plugins/ folder
3. Start the server
4. Done! Use /baubles in-game

First Accessory in 60 Seconds

/curios create speed_ring
In the GUI: set the name, material, slot type → add a Speed ability → add a recipe → done.

/curios give speed_ring
/baubles

Place it in a ring slot — Speed I activates!


⚙️ Configuration Highlights

Full configuration reference → curiospaper.run.place


Documentation


The full documentation site covers: Getting Started, Configuration, Systems, GUI Editors, Developer API, and Examples.


What's New in v1.3.2

• ️ ️ Admin Inspect — View and edit online/offline players' accessories directly using `/curios inspect`
• ⚙️ NBT & Enchants Editor GUI — Manage item PDC/NBT tags (`key = type:value`), edit enchants, toggle glint/unbreakable/placeable
• RTP Dismount Compatibility — Interactively record portal/RTP sequences and prevent passenger glitches during random teleports
• Hosting Modes & Cache-Busting — Support for SELF, LINK, and NONE resource pack modes with auto hash query cache-busting
• Exact Choice Recipes — Upgrade custom recipe choices to `ExactChoice` for perfect item ingredient matching
• ‍ Base64 Head Skins — Set custom textures and skins via URLs/Base64 strings on custom player heads programmatically or in YAML

Full changelog → CHANGELOGS.md


Community



☕ Support the Project



For Developers

Maven
plugin.yml
Full API docs → curiospaper.run.place/api