TrimBlades — Overview

Version: 1.0.0
Minecraft Version: Paper 1.21+
Developer: CiscoCodes (Modrinth)

Introduction

TrimBlades is a premium Minecraft Paper 1.21+ plugin that reimagines combat through the armor trim system. Every Minecraft armor trim template becomes a unique legendary blade with its own ability, visual effects, and playstyle — 19 blades in total. Crafted in the smithing table using trim templates, a diamond sword, and a netherite ingot, each blade transforms familiar materials into weapons of extraordinary power.

TrimBlades features a one-blade-per-player inventory limit (expandable via the Dragon Egg Blade), anti-duplication protections, ritual crafting mode, trust-based PvP systems, and full SMP management tools including grace periods and world border expansion.

Features

Core Features

19 Unique Legendary Blades — one for every armor trim template, plus the Dragon Egg
Smithing Table Crafting — Template + Diamond Sword + Netherite Ingot
Trimmed Sword Inventory Limit — Players can hold only 1 trimmed sword at a time (configurable)
Dragon Egg Blade Expansion — Increases limit to 2 and grants 10% cooldown reduction
Cooldown Dial — Craftable offhand item that reduces all ability cooldowns by 50%
Passive Blade Effects — Some blades grant buffs while held (regeneration, detection, resistance)
Command-Based Ability Activation — Use /tb <trimname> as an alternative to right-click
Trust System — Trust players to prevent your abilities from targeting them
Configurable Keybinds — Right-click or command-based ability triggers
Custom Particle Effects for every blade ability
Sound Effects and immersive audio feedback
Sword Recipe GUI — View all blade recipes in an interactive GUI
Global Crafting Announcements (optional, with privacy toggle)
Admin Management Tools for full server control

Protection Systems

Container Protection — Configurable sword storage restrictions
Hopper Protection — Prevents hoppers from picking up blades
Item Frame Protection — Blocks placement in item frames
Bundle Protection — Prevents putting blades in bundles
Anvil Protection — Configurable renaming and enchanting restrictions
Inventory Restriction — Enforces trimmed sword carry limits

Ritual Crafting System

Ritual Mode — Transform smithing table crafting into server-wide events
3D Sword Display — Floating, rotating sword model during ritual charging
Protection Zones — Configurable radius around ritual sites
Boss Bar Progress — Charge percentage visible to all players
Concurrent Limits — Maximum 1-3 rituals server-wide (configurable)
Queue System — Automatic queuing when limits reached
Persistence — Active rituals survive server restarts

SMP Management

SMP Start System — Full server launch sequence with countdown, world border expansion, and grace period
Grace Period System — PvP protection with BossBar/ActionBar countdown, per-player support for late joiners
World Border Expansion — Configurable border growth with speed, size, and countdown settings

Localization

Multi-Language Support — 8 built-in languages (English, Spanish, French, German, Polish, Dutch, Hindi, Urdu)
Auto-Detection — Automatically detects client language on join
Per-Player Language — Players can choose their own language

Trust System — Trust up to 5 players (configurable) to prevent ability targeting
Unidirectional Trust — Trusting someone doesn't mean they trust you back

Blade Playstyles

Each blade belongs to a distinct combat archetype:

Playstyle	Description
Duelist	Direct damage and aggressive combat
Initiator	Gap-closing and fight-starting abilities
Controller	Crowd control, area denial, and debuffs
Sentinel	Defensive sustain and protection
Support	Utility, tracking, and team enhancement

Special Items

Item	Description
Cooldown Dial	Offhand item — reduces all ability cooldowns by 50%. Crafted with Clock + Nether Star + 4 Diamonds.
Dragon Egg Blade	Increases trimmed sword carry limit to 2 and provides 10% cooldown reduction to all abilities.

Dependencies

FaithBreak — Required dependency, auto-downloaded from Modrinth on first startup
ProtocolLib — Soft dependency, auto-downloaded from GitHub if missing (required for Flow Blade mount controls and Bolt Blade passive glowing)

Support & Credits

Modrinth: modrinth.com/plugin/trimblades
Discord: Join for bug reports, suggestions, and community discussion
Privacy: No data collection — plugin operates entirely offline