# ⚔️ PaperArtifacts ⚔️ ### 45+ Magical Accessories & Exploration Content for CuriosPaper [![Version](https://img.shields.io/badge/version-1.3-blueviolet?style=for-the-badge)](https://github.com/Brothergaming52/Artifacts/releases) [![Minecraft](https://img.shields.io/badge/minecraft-1.14.4%20—%2026.1+-green?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNSAyIDIgNi41IDIgMTJzNC41IDEwIDEwIDEwIDEwLTQuNSAxMC0xMFMxNy41IDIgMTIgMnoiLz48L3N2Zz4=)](https://www.spigotmc.org/) [![Discord](https://img.shields.io/discord/1456137607569346739?label=Discord&style=for-the-badge&logo=discord&logoColor=white&color=5865F2)](https://discord.gg/r5YXqgrGya) [![bStats](https://img.shields.io/badge/bStats-live-blue?style=for-the-badge)](https://bstats.org/plugin/bukkit/Artifacts/30728) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Me-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/brothergaming52) **Hats · Necklaces · Belts · Gloves · Boots · Mimics · Campsites**
A content addon for [CuriosPaper](https://github.com/Brothergaming52/CuriosPaper) — explore, loot, and equip. --- *A unofficial server-side port of the popular [**Artifacts**](https://modrinth.com/mod/artifacts) mod by [ochotonida](https://github.com/ochotonida/artifacts).*
*No client mods required. Just drop it in alongside CuriosPaper and your world fills with discoverable treasures.*

--- ## 🧩 What is PaperArtifacts? PaperArtifacts brings the beloved [Artifacts mod](https://modrinth.com/mod/artifacts) experience to **Paper & Spigot** servers as an addon for [CuriosPaper](https://modrinth.com/plugin/curiospaper). It adds **45+ unique magical items** with custom textures that players can discover through **dungeon loot, mob drops, and abandoned campsites** — underground structures that generate naturally in your world. Some chests in those campsites might be **Mimics** — hostile mobs disguised as chests that attack when opened!

All available artifact items stored in a chest

Every item is fully configurable, has a custom resource pack model, and works out of the box. --- ## 🚀 What's New in v1.3 - 🛠️ **Full Item Customization (`artifacts.yml`):** Fully customize every artifact item's display name, material, CustomModelData, item-model key, slot type, lore, 3D model settings, and custom abilities. - 👹 **Mimic Spawning & Modern Lifecycle:** Added `/artifacts mimic` command to spawn mimic chests at your location. Refactored entity spawning with modern consumer callbacks for clean, glitch-free lifecycle management. - 📐 **Configurable Charm of Shrinking:** Added customizable `scale-modifier` and `scale-operation` configuration options for the Charm of Shrinking on 1.20.5+. - 🏕️ **Enhanced Campsite Population & Config:** Improved campsite generation density control and robust configuration fallback compatibility across `campsite.yml` and `config.yml`. - ⚡ **Instant Hot Reload & Attribute Safety:** `/artifacts reload` now updates item registrations, abilities, campsites, and mimic drops on the fly. Attribute modifier handling is hardened with multi-identifier cleanup to prevent phantom modifiers. - 🌐 **Robust Version Parsing:** Upgraded regex-based server version parser ensuring seamless compatibility across custom Paper forks and modern build strings. --- ## ⚡ Key Features - ⚔️ **45+ artifacts** across head, necklace, belt, hands, and feet slots - 🎨 **Custom resource pack** with unique textures for every item — auto-merged with CuriosPaper - 🏕️ **Abandoned campsites** that generate underground with loot, furniture, and traps - 👹 **Mimics** — chest-shaped mobs hiding in campsites that attack when you try to open them - 🗺️ **Loot table integration** — artifacts appear in vanilla dungeon chests, temples, bastions, and more - 🧟 **Mob drops** — themed artifacts drop from specific mobs - ⚙️ **Fully configurable** — enable/disable and tune every item and feature in `config.yml` and `artifacts.yml` - 🔧 **Hot reload** — `/artifacts reload` applies changes instantly --- ## 🎒 The Artifacts

Player with Crystal Heart 3D model equipped Player with Helium Flamingo 3D model equipped

### 🎩 Head | Item | What it does | |---|---| | **Snorkel** | Breathe underwater | | **Villager Hat** | Better villager trade prices | | **Superstitious Hat** | +1 Looting on mob kills | | **Cowboy Hat** | Faster mounts | | **Plastic Drinking Hat** | Eat & drink faster | | **Novelty Drinking Hat** | Eat & drink even faster | | **Night Vision Goggles** | See in the dark | | **Angler's Hat** | Better fishing luck & speed | ### 📿 Necklace | Item | What it does | |---|---| | **Lucky Scarf** | +1 Fortune on blocks | | **Cross Necklace** | Longer invincibility after damage | | **Panic Necklace** | Speed boost when hit | | **Shock Pendant** | Chance to strike attackers with lightning | | **Flame Pendant** | Chance to ignite attackers | | **Scarf of Invisibility** | Goes invisible | | **Thorn Pendant** | Reflects damage to attackers | | **Charm of Sinking** | Walk freely in water | | **Charm of Shrinking** | Shrinks the player *(1.20.5+)* | ### 🔋 Belt | Item | What it does | |---|---| | **Cloud in a Bottle** | Double jump | | **Obsidian Skull** | Fire resistance on fire damage | | **Antidote Vessel** | Reduces negative effect duration | | **Universal Attractor** | Pulls nearby items to you | | **Crystal Heart** | +5 bonus hearts | | **Helium Flamingo** | Swim through the air | | **Chorus Totem** | Teleports you to safety on death *(consumed)* | | **Warp Drive** | Ender Pearls cost hunger, not the item | ### 🧤 Hands | Item | What it does | |---|---| | **Digging Claws** | Mine stone barehanded + haste | | **Feral Claws** | Faster attack speed | | **Power Glove** | More melee damage | | **Fire Gauntlet** | Melee attacks set enemies on fire | | **Pocket Piston** | Extra knockback | | **Vampiric Glove** | Lifesteal on melee hits | | **Golden Hook** | More XP from kills | | **Onion Ring** | Haste after eating | | **Pickaxe Heater** | Auto-smelts mined ores | | **Withered Bracelet** | Chance to inflict Wither on hit | ### 👟 Feet | Item | What it does | |---|---| | **Aqua-Dashers** | Walk on water while sprinting | | **Bunny Hoppers** | Jump Boost + no fall damage | | **Kitty Slippers** | Creepers run away from you | | **Running Shoes** | Faster speed & step height while sprinting | | **Snowshoes** | Walk on Powder Snow + less slippery ice | | **Steadfast Spikes** | Knockback immunity | | **Flippers** | Swim faster (Dolphin's Grace) | | **Rooted Boots** | Regenerate hunger on grass | | **Strider Shoes** | Walk on lava while sneaking | ### 🍖 Held Items | Item | What it does | |---|---| | **Umbrella** | Slow fall + works as a shield | | **Everlasting Beef** | Infinite raw beef | | **Eternal Steak** | Infinite cooked steak *(cook the beef!)* | --- ## 🏕️ Campsites & Mimics **Abandoned campsites** generate underground in caves. They contain beds, crafting stations, furnaces, barrels, and loot chests — some with artifacts inside.

A naturally spawned abandoned campsite underground

But be careful — some chests are actually **Mimics**. They look like normal chests, but when you open one, it transforms into a hostile mob with custom animations and sounds. Mimics only exist inside campsites and won't activate unless you interact with them. Defeat one to earn a random artifact!

A mimic attacking the player

Chests can also be **trapped** with TNT underneath. Exploration is rewarding — but risky. --- ## 📦 How to Find Artifacts | Method | Description | |---|---| | 🗺️ **Loot Chests** | Found in dungeons, temples, bastions, end cities, mineshafts, and more | | 🧟 **Mob Drops** | Specific mobs drop themed artifacts (e.g. Drowned → Flippers) | | 🏕️ **Campsites** | Underground structures with loot chests and a chance for artifacts | | 👹 **Mimics** | Kill a mimic in a campsite for a guaranteed artifact | | 📋 **Commands** | `/curios give [player]` or `/artifacts mimic` | --- ## 🎮 Commands | Command | Description | Permission | |---|---|---| | `/artifacts mimic` | Spawn a mimic chest at your location | `artifacts.admin` | | `/artifacts list` | List all artifacts | `artifacts.admin` | | `/artifacts reload` | Reload config | `artifacts.admin` | --- ## 🔧 Requirements | | | |---|---| | **Minecraft** | 1.14.4 — 26.1+ | | **Server** | Paper, Spigot, Purpur | | **Java** | 8+ | | **GeyserMC** | Supported (custom Bedrock resource pack & mappings included) | | **Required** | [CuriosPaper](https://modrinth.com/plugin/curiospaper) v1.3.0+ | ### 🌐 Geyser & Bedrock Edition Support PaperArtifacts provides full GUI slot icon and item texture support for Bedrock Edition players joining via GeyserMC. - **Automatic Setup:** If Geyser is running on the same server, PaperArtifacts will automatically detect Geyser's folder on startup, extract the mappings and resource pack, and copy them directly to Geyser's `packs/` and `custom_mappings/` folders. - **Manual Setup (Proxy/Separate Server):** If Geyser is hosted on a separate proxy (e.g. Velocity/BungeeCord) or automatic setup is skipped: 1. Retrieve the files from your server's `plugins/Artifacts/geyser/` directory (extracted on startup). 2. Copy `Artifacts_Geyser.zip` into your Geyser `packs/` folder. 3. Copy `Artifacts_mappings.json` into your Geyser `custom_mappings/` folder. 4. Ensure `enable-custom-content` is set to `true` in Geyser's `config.yml` and restart Geyser. --- ## 📥 Getting Started 1. Install [CuriosPaper](https://modrinth.com/plugin/curiospaper) on your server 2. Drop `Artifacts.jar` into your `plugins/` folder 3. Start the server — done! Artifacts will start appearing in dungeon chests, dropping from mobs, and generating in campsites across your world. Use `/baubles` to open the accessory menu and equip them. --- ## 📊 Stats

--- ## 🙏 Credits PaperArtifacts is inspired by and based on the original [**Artifacts**](https://modrinth.com/mod/artifacts) mod by [**ochotonida**](https://github.com/ochotonida/artifacts), originally made for Forge and Fabric. This plugin is a server-side reimplementation for Paper & Spigot using the [CuriosPaper](https://modrinth.com/plugin/curiospaper) accessory system. This is not a official port. --- ## 💬 Community & Support

[![Discord](https://img.shields.io/discord/1456137607569346739?label=Join%20the%20Discord&style=for-the-badge&logo=discord&logoColor=white&color=5865F2)](https://discord.gg/r5YXqgrGya) **[discord.gg/r5YXqgrGya](https://discord.gg/r5YXqgrGya)** Get help · Report bugs · Suggest features --- [![Ko-fi](https://img.shields.io/badge/Ko--fi-Buy%20me%20a%20coffee-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/brothergaming52) **[ko-fi.com/brothergaming52](https://ko-fi.com/brothergaming52)**

---

**Made with ❤️ by Brothergaming52** [CuriosPaper](https://modrinth.com/plugin/curiospaper) · [Discord](https://discord.gg/r5YXqgrGya) · [Ko-fi](https://ko-fi.com/brothergaming52) · [bStats](https://bstats.org/plugin/bukkit/Artifacts/30728)

PaperArtifacts

1.3

1.2

1.1

1.0