TrimBlades — Configuration
All plugin configuration is managed through a single unified config.yml file in plugins/TrimBlades/.
Blade Ability Attributes
All ability attributes are configurable per blade. Values include cooldowns (seconds), durations (seconds), ranges (blocks), damage, knockback, and counts.
abilities:
ward:
cooldown: 45
duration: 0
range: 16
count: 0
knockback: 0
damage: 8.0
coast:
cooldown: 30
duration: 0
range: 15
count: 0
knockback: 0
damage: 0
raiser:
cooldown: 20
duration: 0
range: 10
count: 0
knockback: 0
damage: 6.0
wayfinder:
cooldown: 60
duration: 30
range: 500
count: 0
knockback: 0
damage: 0
host:
cooldown: 90
duration: 300
range: 0
count: 0
knockback: 0
damage: 0
sentry:
cooldown: 60
duration: 30
range: 0
count: 3
knockback: 0
damage: 0
vex:
cooldown: 60
duration: 30
range: 0
count: 3
knockback: 0
damage: 0
wild:
cooldown: 35
duration: 10
range: 8
count: 0
knockback: 0
damage: 1.0
dune:
cooldown: 30
duration: 30
range: 8
count: 0
knockback: 0
damage: 1.0
shaper:
cooldown: 35
duration: 180
range: 0
count: 1
knockback: 0
damage: 0
silence:
cooldown: 90
duration: 300
range: 0
count: 0
knockback: 0
damage: 0
tide:
cooldown: 30
duration: 10
range: 15
count: 0
knockback: 3
damage: 6.0
snout:
cooldown: 60
duration: 30
range: 15
count: 3
knockback: 0
damage: 2.0
rib:
cooldown: 0
duration: 0
range: 0
count: 0
knockback: 0
damage: 0
eye:
cooldown: 45
duration: 20
range: 20
count: 0
knockback: 0
damage: 0
spire:
cooldown: 60
duration: 0
range: 10
count: 0
knockback: 0
damage: 12.0
flow:
cooldown: 30
duration: 90
range: 0
count: 0
knockback: 3
damage: 0
bolt:
cooldown: 40
duration: 0
range: 20
count: 0
knockback: 0
damage: 4.0
dragon_egg:
cooldown: 45
duration: 0
range: 0
count: 0
knockback: 0
damage: 0
Special Ability Settings
Fine-tuned settings for specific blade mechanics.
# Wayfinder tracking radius (set to "inf" for unlimited)
wayfinder_radius: 500
# Host mimic random chance percentage
host_random_chance: 25
# Ward sonic boom beam damage
ward_beam_damage: 8.0
# Coast riptide launch power
coast_riptide_power: 2.5
# Rib passive defense duration (seconds)
rib_resistance_duration: 10
# Rib passive offense damage multiplier
rib_damage_multiplier: 1.3
# Flow wind charge explosion toggle
flow_wind_charge_explosions: false
# Eye rewind mode: "seconds" or "blocks"
eye_rewind_mode: "seconds"
eye_rewind_seconds: 20
eye_rewind_blocks: 20
# SkyFall (Dragon Egg) settings
skyfall:
launch_velocity: 2.5
base_explosion_radius: 8.0
base_explosion_damage: 15.0
min_explosion_power: 2.0
max_explosion_power: 4.0
elytra_compatible: true
Trust System
Trimmed Sword Inventory Limit
Buffs & Special Items
buffs:
dragon_egg:
dual_abilities: true # Allows carrying 2 trimmed swords
max_trimmed_swords: 2 # Carry limit when Dragon Egg Blade is held
cooldown_reduction: 10 # Percentage cooldown reduction for all abilities
cooldown_dial:
cooldown_reduction: 50 # Percentage cooldown reduction when held in offhand
Container Protection
Controls whether blades can be placed in containers and interacted with in anvils.
protection:
allow-container-storage: false # Allow blades in chests, barrels, shulkers, etc.
allow-item-frames: false # Allow blades in item frames
allow-hopper-pickup: false # Allow hoppers to pick up blades
allow-anvil-renaming: false # Allow renaming blades in anvils
allow-anvil-enchanting: false # Allow adding enchantment books to blades in anvils
Grace Period System
Controls the PvP protection grace period when starting the SMP.
grace-period:
duration: 900 # Duration in seconds (default: 900 = 15 minutes)
display-type: BOSSBAR # Display type: BOSSBAR or ACTIONBAR
bossbar-color: PURPLE # BossBar color: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
prevent-chest-access: false # Block other players' chest access during grace
per-player-enabled: true # Enable per-player grace periods for late joiners
World Border Expansion
Settings for the world border expansion system.
world-border:
initial-size: 50 # Starting border size in blocks
final-size: -1 # Final size (-1 = Minecraft default 60,000,000)
expansion-duration: 30 # Duration of expansion in seconds
expansion-countdown: 10 # Countdown before expansion starts (seconds)
Countdown Effects
Visual and audio effects during the SMP start countdown.
countdown-effects:
countdown-title: "TrimBlades SMP"
countdown-subtitle: "Starting in {seconds}"
countdown-title-color: "DARK_PURPLE"
countdown-subtitle-color: "LIGHT_PURPLE"
countdown-sound: "BLOCK_NOTE_BLOCK_PLING"
sound-volume: 1.0
sound-pitch: 1.0
Expansion Announcement
Announcement settings when the world border starts expanding.
expansion-announcement:
expansion-title: "World Expanding!"
expansion-subtitle: "The world border is growing..."
expansion-title-color: "GREEN"
expansion-subtitle-color: "AQUA"
chat-announcement: true
chat-message: "The world border is expanding! Prepare for adventure!"
Startup Messages
Messages displayed after the world border expansion starts.
startup-messages:
enabled: true
sound-sequence:
thunder:
enabled: true
sound: "ENTITY_LIGHTNING_BOLT_THUNDER"
volume: 2.0
pitch: 0.9
delay: 0
dragon:
enabled: true
sound: "ENTITY_ENDER_DRAGON_GROWL"
volume: 2.0
pitch: 0.8
delay: 1
separator: "----------------------------------------"
message1:
enabled: true
text: "TrimBlades SMP has started!"
message2:
enabled: true
text: "All players get {grace_period} min grace period (PvP disabled)"
message3:
enabled: true
text: "Welcome to the ultimate survival experience!"
message4:
enabled: true
text: "Good luck, everyone! ~ CiscoCodes"
Ritual Crafting System
Overview
Ritual crafting transforms blade creation into dramatic server-wide events where players must defend a charging ritual while the blade materializes in 3D space.
How Ritual Crafting Works
1. Initiation
- Player crafts a TrimBlade in the smithing table
- System detects craft completion
- Instead of giving item: Destroys the smithing table and starts ritual
- 3D sword model spawns above the crafting location
2. Ritual Process
- 3D Model: Full-scale sword floating and rotating in air
- Animation: Gentle bobbing motion (configurable amplitude)
- Rotation: Configurable rotation speed
- Duration: Configurable per blade (default 300s)
3. Visual Effects
- Particle Effects: Flame particles in spiral pattern, enchantment glint orbiting
- Intensity: Increases as charge progresses
- Hologram Display: Blade name, charge percentage, time remaining
4. Server Announcements
- Title Display (All Players): Configurable title, subtitle, colors, and duration
- Boss Bar — Progress from 0% to 100%, configurable color, visible to all
5. Protection & Effects
- Protection Zone: Configurable radius around ritual site (default 15 blocks)
- Enhanced Spawning: Configurable mob spawn rate increase
- Block Protection: Configurable building restrictions
- PvP Settings: Configurable combat rules in ritual zones
6. Completion
- Lightning strike visual + thunder sound
- 3D sword model drops as actual item
- Configurable completion announcement to all players
Ritual Configuration
ritual-mode:
enabled: false
max-concurrent-rituals: 3
default-duration: 300
ritual-durations:
ward: 300
coast: 300
raiser: 300
wayfinder: 300
host: 300
sentry: 300
vex: 300
wild: 300
dune: 300
shaper: 300
silence: 300
tide: 300
snout: 300
rib: 300
eye: 300
spire: 300
flow: 300
bolt: 300
dragon_egg: 300
queue-settings:
max-queue-size: 50
max-wait-time: 10
process-interval: 1
announcement-settings:
title-duration: 5
subtitle-fade: 2
boss-bar-color: "PURPLE"
ritual-start-title: "TrimBlades RITUAL"
ritual-start-subtitle: "Defend the blade as it charges!"
ritual-complete-title: "Ritual Complete!"
ritual-complete-subtitle: "{sword_name} has been forged!"
protection-settings:
radius: 15
block-breaking: false
pvp-enabled: true
mob-spawn-multiplier: 1.5
persistence-settings:
auto-save: true
save-interval: 60
Sword Display (Rituals)
display-method: "ItemDisplay" # Methods: ItemDisplay (1.19.4+), BlockDisplay, TextDisplay, ArmorStand
animation:
rotation-speed: 0.314159
bobbing:
amplitude: 0.5
frequency: 0.1
visual:
scale: 1.0
glow: true
brightness: 15
Enchantment Configuration
Default enchantments applied to each blade when crafted. All disabled by default — enable per blade as desired.
enchantments:
ward:
enabled: false
sharpness: 5
unbreaking: 3
mending: 1
coast:
enabled: false
sharpness: 5
unbreaking: 3
mending: 1
# ... (all 19 blades configurable with same structure)
Runtime-Generated Files
The following files are created automatically at runtime:
| File | Purpose |
|---|---|
player_languages.yml |
Stores per-player language preferences |
gracedplayers.yml |
Tracks players who have received grace periods (prevents repeats) |
smp_state.yml |
Persists SMP state (who started, when, active status) |
Language Files
8 built-in language files are located in plugins/TrimBlades/languages/:
| File | Language |
|---|---|
en_US.yml |
English (US) |
es_ES.yml |
Spanish |
fr_FR.yml |
French |
de_DE.yml |
German |
pl_PL.yml |
Polish |
nl_NL.yml |
Dutch |
hi_IN.yml |
Hindi |
ur_PK.yml |
Urdu |
Players' client language is auto-detected on join. Language preference can be changed with /tb language <code>.