Skip to content

TrimBlades — Compatibility & Troubleshooting

Server requirements, compatibility info, and common issue fixes.

Server Requirements

Requirement Value
Minecraft Version Paper 1.21+
Java Version Java 21 or higher
Server Software Paper (Spigot compatibility not guaranteed)
RAM Minimum 2GB allocated to server

Plugin Dependencies

  • FaithBreak — Required dependency, auto-downloaded from Modrinth on first startup (project ID: Jghhg4Vq)
  • ProtocolLib — Soft dependency, auto-downloaded from GitHub if missing. Required for:
    • Flow Blade mount controls (WASD packet handling)
    • Bolt Blade passive glowing effect (client-side entity metadata)
  • Optional Integrations:
    • PlaceholderAPI (enhanced message formatting)
    • WorldGuard (region-based restrictions)

Known Compatibility

Status Details
✅ Compatible Most economy, permission, and utility plugins
✅ Compatible Anti-cheat plugins (properly configured)
⚠️ Caution Plugins that modify smithing table mechanics
⚠️ Caution Plugins that modify armor trim behavior
❌ Conflicts Other weapon plugins that override vanilla sword mechanics

Troubleshooting

Blades Not Crafting

  1. Ensure crafting uses a smithing table (Template + Diamond Sword + Netherite Ingot)
  2. Verify the player has access to smithing tables
  3. Check if ritual mode is enabled: /tb craft-mode normal to switch back
  4. Check server console for recipe registration errors

Abilities Not Working

  1. Check cooldown status — abilities have configurable cooldown periods
  2. Ensure player has the blade equipped in main hand
  3. Right-click or use /tb <trimname> to activate
  4. For Coast Blade: player must be in water or rain
  5. For Shaper Blade: player must have armor equipped
  6. For Host Blade: player must have hit someone with a trimmed sword first
  7. For trust-related issues, check if target is trusted: /tb untrust <player>

Flow Blade Not Responding to Controls

  1. Ensure ProtocolLib is installed and loaded
  2. Check server console for ProtocolLib errors
  3. Use WASD to move while riding, double-shift to dismount

Bolt Blade Glowing Not Visible

  1. Requires ProtocolLib for client-side glowing packets
  2. Verify ProtocolLib version is 5.3.0+
  3. Check that target players are not trusted

Ritual Mode Issues

  1. Check ritual mode is enabled: /tb craft-mode ritual
  2. Verify no concurrent ritual limit reached: /tb ritual status
  3. Ensure smithing table placement is valid
  4. Check for area protection conflicts

SMP / Grace Period Issues

  1. Check SMP status: /tb smp status
  2. View grace period status: /tb gp status
  3. Reload configurations: /tb smp reload or /tb gp reload
  4. Reset SMP state: /tb smp reset

Inventory Limit Issues

  1. Default limit is 1 trimmed sword per player
  2. Dragon Egg Blade increases limit to 2
  3. If a player can't pick up blades, check if they've reached the limit
  4. Cooldown Dial occupies the offhand slot, not the trimmed sword limit

Language Issues

  1. Language auto-detects on join based on client locale
  2. Manually set language: /tb language <code> (e.g., en_US, es_ES)
  3. Blade names in inventory refresh automatically on language change

Performance Problems

  1. Reduce particle-heavy abilities in high-player scenarios
  2. Lower concurrent ritual limits in config
  3. Check for plugin conflicts with entity spawning (Sentry/Vex blades)
  4. Monitor server TPS during Dune Blade tornadoes and Snout Blade arenas

Error Messages

Message Meaning
"You already have the maximum number of trimmed swords!" Player has reached their carry limit (1 or 2 with Dragon Egg)
"Ritual limit reached" Too many concurrent rituals active
"Insufficient permissions" Player lacks required permission node
"You must be in water or rain!" Coast Blade activation requires water/rain
"You must be wearing armor!" Shaper Blade requires armor equipped
"No ability copied!" Host Blade has no stored ability to use

Texture Pack

TrimBlades includes a custom texture pack located in TrimBlades Texture Pack/. This resource pack provides:

  • Custom Netherite Sword Models — Unique textures for each of the 19 trimmed blades (via CustomModelData 1001-1019)
  • Cooldown Dial Texture — Custom clock texture (CustomModelData 1020)

Install the resource pack on your server or distribute to players for the full visual experience.