✨ OutArcaneTrap — Ultimate Custom Wall & Trap System for Minecraft

The most advanced custom items plugin for Minecraft Paper 1.21+. Place .schem structures with a right-click, build 5x5 walls instantly, and create amazing gameplay mechanics with full protection and restoration!

---

🏗️ About OutArcaneTrap

OutMagicItems is a powerful and flexible plugin that allows you to create magical items that place custom structures from .schem files or build 5x5 walls instantly. Perfect for traps, arenas, custom gameplay mechanics, or just adding some magic to your server!

Unlike other schematic plugins, OutMagicItems saves every original block before placing a structure and perfectly restores them when the structure expires — including container contents like chests, barrels, and shulkers! No more broken builds or lost items.

---

✨ Feature Showcase

🏗️ Schematic System

Feature	Description
.schem Support	Place any WorldEdit schematic with a right-click
Block Restoration	Every original block is saved and perfectly restored
Container Saving	Chests, barrels, shulkers contents are saved and restored
Protection Zone	Configurable radius around structures where building/breaking is blocked
Intersection Prevention	Structures cannot overlap with each other
Multiple Placement Modes	feet, target, absolute, relative placement options
Offset Controls	Fine-tune X, Y, Z offsets for perfect positioning

🧱 Wall System (5x5 "Plast")

Feature	Description
6 Direction Support	Walls place correctly when looking: North, South, East, West, Up, Down
Random Block Mixing	Create walls with random block percentages (40% stone, 30% cobble, etc.)
Custom Materials	Define exactly which blocks appear in your walls
Perfect Orientation	Walls always place perpendicular to your view
Protection Zone	2-block radius protection around walls (configurable)

⚡ Trap Effects

Feature	Description
Potion Effects	Apply effects to enemies in radius: FIRE, POISON, SLOW, WEAKNESS, WITHER, BLINDNESS, HUNGER
Effect Radius	Configurable radius for each trap
Owner Bypass	Option to not apply effects to the player who placed the trap
Check Interval	Configurable how often effects are applied

🔊 Audio & Visual

Feature	Description
Place Sounds	Custom sounds when placing structures/walls
Remove Sounds	Custom sounds when structures expire
Small Caps Support	Beautiful small caps text formatting with colors
Custom Item Names	Full color & formatting support with & codes

🔒 Protection System

Feature	Description
Structure Protection	Players cannot break blocks that are part of active structures
Perimeter Protection	Configurable radius around structures where building/breaking is blocked
Intersection Prevention	Structures cannot be placed overlapping existing ones
Player Quit Cleanup	All player structures are removed when they leave

---

📋 Requirements

Requirement	Version	Reason
Paper	1.21+	Core server software
WorldEdit	7.4.0+	Required for .schem file support
Java	21+	Required for Paper 1.21

⚠️ IMPORTANT: WorldEdit is REQUIRED for this plugin to work! The plugin will not enable without WorldEdit installed.

---

📥 Installation Guide

Step	Action
1️⃣	Install WorldEdit — Download and install WorldEdit 7.4.0+ first
2️⃣	Download — Get the latest .jar from Modrinth
3️⃣	Install — Place the JAR into your server's plugins/ folder
4️⃣	Restart — Restart your server (DO NOT use /reload)
5️⃣	Configure — Edit configuration files in plugins/OutMagicItems/
6️⃣	Add Schematics — Place your .schem files in plugins/OutMagicItems/schems/
7️⃣	Enjoy! — Give items with /omi give <player> <item-id> [amount]

---

🎮 Commands & Permissions

👤 Player Commands

Command	Description	Permission	Default
/omi list	List all available items and walls	outmagicitems.use	✅ All players
/outmagicitems	Alias for main command	outmagicitems.use	✅ All players
/omi	Alias for main command	outmagicitems.use	✅ All players

👑 Admin Commands

Command	Description	Permission	Default
/omi give <player> <item> [amount]	Give item to player	outmagicitems.admin	❌ Ops only
/omi reload	Reload all configurations	outmagicitems.admin	❌ Ops only
/omi debug	Show active structures info	outmagicitems.admin	❌ Ops only

🔑 Permissions

Permission	Description	Default
outmagicitems.use	Use basic plugin commands and items	✅ All players
outmagicitems.admin	Admin commands (give, reload, debug)	❌ Ops only

---

❓ Frequently Asked Questions

Do I need WorldEdit?

YES! WorldEdit 7.4.0+ is REQUIRED for .schem file support. The plugin will not enable without WorldEdit installed.

Where do I put my .schem files?

Place them in plugins/OutMagicItems/schems/. The plugin will automatically create this folder on first start.

Does it save container contents?

YES! All chests, barrels, shulkers, and any inventory holder contents are saved and perfectly restored when the structure expires.

Can players build inside structures?

No! The protection system prevents block breaking/placing within the structure and in the configurable radius around it.

What happens if two structures overlap?

The plugin prevents overlapping structures. You cannot place a new structure that intersects with an existing one.

Do walls work when looking up/down?

YES! When you look straight up or down, the wall places horizontally as a floor or ceiling.

Can I use random blocks in walls?

YES! You can configure percentages for different blocks in the walls.yml file.