⚔️ GuildWars – The Ultimate Custom Enchantments & Guild PvP Plugin
Tested Minecraft Versions: 1.17–1.21.6
Source Code: GitHub – FrostlineTech/GuildWars
Contributors: Dakota Fryberger
Support & Community: Join our Discord
Compatible with: Paper, Spigot, Purpur
Dependencies: None

GuildWars is an all-in-one plugin built for epic PvP, immersive survival gameplay, and a fully custom enchantment experience far beyond vanilla Minecraft. Whether you're running a factions server, fantasy RPG world, or a survival guild-based community, GuildWars enhances your server with powerful features — without sacrificing performance.

✨ Key Features
Custom Enchantment System

• 28+ fully custom enchantments for swords, bows, axes, tools, and armor
  
  
• Unique effects: Tunneling, Explosive Arrows, Shadowstep, Vampiric Edge, and more
  
  
• Found through structure loot, enchanting, or via admin commands
  
  
• Visual FX: particles, glowing items, custom sounds, and floating damage numbers
  
  
• Fully configurable rarity levels, level caps, and loot chances
  

Guild & PvP Systems

• Create and manage player guilds with optional territory control
  
  
• Guild-specific tools, upgrades, and PvP stat bonuses
  
  
• Balanced gameplay: no pay-to-win, everything customizable
  

Custom Mobs Engine

• Spawn unique, powerful mobs with tailored combat behaviors:
  
  • Frost Giant – Emits a frost aura that slows nearby players
    
    
  • Shadow Assassin – Teleports behind targets and uses potion attacks
    
    
  • Corrupted Warden – Boss with EMP bursts and minion spawns
    
• Admin commands for testing and summoning
  
  
• Configurable AI and behavior files
  

️ Admin Tools & Commands

• Quick testing and control via:
  
  • /guildadmin enchant, /give, /godmode, /summon, /guildadmin mobspawn
    
• Modular permissions and detailed debug logging
  

Visual & Performance Enhancements

• Floating combat text, boss health bars, and custom particles
  
  
• Lightweight design optimized for large servers
  
  
• Efficient cooldowns, automatic data cleanup, and optimized entity rendering
  

Installation

1. Drop the .jar file into your /plugins folder
   
   
2. Restart the server
   
   
3. Configure config.yml if needed
   
   
4. Enjoy — everything activates automatically
   

Version 1.4.5 Update (June 18, 2025)
✅ Full Compatibility with Minecraft 1.21.6

New & Improved:

• Updated Plugin Core for full support with Minecraft 1.21.6
  
  
• Mob AI Fixes – Frost Giant and Corrupted Warden now correctly target players
  
  
• ❤️‍ Boss Health Bars – Enhanced with cleaner formatting and color support
  
  
• ⚙️ Mob Merging – Intelligent entity merging system reduces mob clutter and improves performance
  
  
• Lag Cleanup System – Automatically clears entities to prevent lag spikes (fully configurable)
  
  
• Biome-Based Spawning
  
  • Frost Giants: Naturally spawn in cold biomes (e.g., snowy tundra, frozen oceans)
    
    
  • Corrupted Wardens: Now spawn in plains biomes
    
• New Admin Command – /guildadmin mobspawn to control custom mob spawn rates in real-time
  
  
• Improved Docs – Added detailed setup and config guides for custom mobs
  

Built with ❤️ by Frostline Solutions LLC
Need help or want to contribute? Join our Discord

️ GuildWars v1.4.1 – Hotfix Release (May 22, 2025)
A quick but important update following the v1.4.0 release!

Changelog

• Fixed: Armor Stand Name Bug
  Resolved an issue where mob health bars were incorrectly showing as "Armor Stand" text above entities.
  
  
• ️ Improved Mob Labeling
  Health bars are now more reliable and consistently visible above custom and vanilla mobs.
  
  
• Performance Enhancements
  Optimized entity rendering logic to reduce overhead and improve server performance during combat scenarios.
  

How to Update

1. Replace your old GuildWars.jar with the new version
   
   
2. Restart your server — no config changes required!
   

GuildWars Plugin v1.4.0
An Advanced Custom Enchantment & Guild System Plugin

Now featuring 28+ Custom Enchantments, Unique Boss Mobs, Territory Control, and Optimized Visual Feedback — all in a performance-friendly Spigot plugin!

Custom Enchantments System
Bring a new layer of depth to your server with GuildWars’ enhanced enchantment system — fully configurable, with unique effects and visual feedback!

✨ Features

• ✅ 28+ Powerful, Custom Enchantments
  
  
• Rare Enchantment Drops in Loot & Enchanting Tables
  
  
• Particle & Sound Effects for Each Enchantment
  
  
• ⚙️ Configurable Rarity, Locations, and Behaviors
  
  
• Server Performance Optimized
  

Enchantment Categories
<details> <summary><strong> Pickaxe Enchantments</strong></summary>

• Tunneling – Breaks blocks in a 3×3 area
  
  
• Auto Smelt – Smelts ores upon mining
  
  
• Treasure Hunter I–II – Chance to find bonus loot from ores
  
  
• Haste I–II – Grants a mining speed boost while held
  

</details> <details> <summary><strong> Hoe & Shovel Enchantments</strong></summary>

• Harvester I–III – Harvests crops in a radius
  
  
• Shovel Tunneling – Digs a 3×3 area
  

</details> <details> <summary><strong> Bow Enchantments</strong></summary>

• Explosive Arrow I–III – Creates explosions on impact
  
  
• Multi-Shot I–II – Fires additional arrows
  
  
• Teleport Arrow – Teleports you to the arrow’s landing spot
  
  
• Gravity Well I–II – Pulls nearby entities to the impact
  
  
• Lightning Strike I–II – Improved chance to summon lightning on hit
  

</details> <details> <summary><strong>⚔️ Melee Combat Enchantments</strong></summary>
Sword

• Execute I–III – Bonus damage to low-health enemies
  
  
• Vampiric Edge I–II – Chance to heal on hit
  
  
• Crippling Strike I–III – Applies Slowness
  
  
• Frenzy I–III – Increases attack speed with combos
  
  
• Mark of Death – Marks enemy for bonus damage
  

Axe

• Armor Crack I–IV – Damages armor durability
  
  
• Shockwave I–II – Knocks back nearby enemies
  
  
• Rupture I–III – Applies Bleeding (DoT)
  

</details> <details> <summary><strong>️ Armor Enchantments</strong></summary>
All Armor

• Molten I–II – Sets attackers ablaze
  
  
• Guardians – Spawns Iron Golem ally on hit
  
  
• Second Wind – Regen when under 20% health
  
  
• Stability I–III – Reduces knockback
  
  
• Thorn Burst I–II – AoE damage reflection
  

Boots Only

• Climb – Wall climb like a spider
  
  
• Shock Absorb I–II – Reduces fall damage
  
  
• Speed Boost I–II – Increases sprint speed
  
  
• Shadowstep – Chance to teleport behind attacker
  

</details>
Commands Overview
Command Description
/enchantments View all enchantments
/enchantments [category] Filter by category (bow, pickaxe, etc.)
/guildadmin enchant [type] [level] Add enchantments to items (admin)
/guildadmin give [book_type] [level] Give enchanted books (admin)
/guildadmin godmode Toggle god mode (admin)
⚙️ Server Performance & Optimization

• ✅ Smart material categorization for fast processing
  
  
• Cooldown system for high-impact enchantments
  
  
• ♻️ Auto-cleans unused player data
  
  
• ️ Improved error handling to prevent crashes
  

Visual & UI Enhancements

• Combat UI:
  
  • Floating damage numbers
    
    
  • Monster health bars with color transitions
    
    
  • Red-colored critical hits
    
• Enchantment FX:
  
  • Glow effect on enchanted items
    
    
  • Unique particles per enchantment
    
    
  • Distinct sound cues for triggers
    
    
  • Clean, readable lore formatting
    

Custom Mobs System
Unleash dangerous new foes onto your server:

Mob Abilities
Frost Giant Ice aura slows players around it
Shadow Assassin Teleports behind players, applies debuffs
Corrupted Warden Boss-level mob with EMP blasts, teleportation, minion spawns
Spawn mobs with /guildadmin summon <mobType>

Each mob includes custom AI, visuals, and special attacks!

Other Features

• Guild System – Territory-based control and player factions
  
  
• TreeFeller – Chop entire trees instantly
  
  
• Admin Toolkit – Full suite of helpful commands
  

️ Installation Instructions

1. Place GuildWars.jar in your /plugins folder
   
   
2. Restart your server
   
   
3. Edit config.yml for customization
   
   
4. Enjoy your enhanced Minecraft world!
   

Need Help?
Join our Discord Support Server

Plugin by Frostline Solutions LLC
Made with ❤️ for the Minecraft community.

Let me know if you want a simplified version for BukkitDev or a markdown-converted .yml config guide!

GuildWars Plugin – Patch Notes
️ Version 1.3.5 (Beta for 1.4) – May 23, 2025
New Features
TreeFeller System

• Break the bottom log of a tree to fell the entire tree.
  
  
• Toggleable in config.yml with the option: general.treefeller.
  
  
• Works only on valid tree structures (prevents abuse on player-built structures).
  

✨ Custom Enchantments System

• Rare enchantments now spawn in structure loot (e.g., Desert Temples, Strongholds).
  
  
• 1 in 1000 chance to appear via enchantment tables.
  
  
• New enchantments include:
  
  • Harvester I–III (Hoes only): Harvests crops in a radius (1–3 blocks).
    
    
  • Tunneling (Pickaxes only): Mines a 3×3 block area when a block is mined.
    

️ Admin Features
New Admin Commands

• /guildadmin enchant <type> [level] — Apply custom enchants directly to tools.
  
  
• /guildadmin give <book_type> [level] — Receive custom enchanted books.
  
  
• Includes admin-only enchantments:
  
  • Admin Sharpness: Instantly kills mobs with swords.
    
    
  • Admin Protection: Grants:
    
    • Max defense
      
      
    • Thorns
      
      
    • Fire immunity
      
      
    • Soul sand speed boost
      
      
    • No fall damage
      
• Full tab completion support for all commands and enchant types.
  
  
• TreeFeller toggle also available via config.yml.
  

⚙️ Improvements

• Optimized Tunneling enchantment block detection for reduced lag.
  
  
• Significantly decreased server load when multiple players use custom tools.
  

Known Issues

• Thorns effect on Admin Protection not functioning as intended.
  (Will be resolved before final 1.4 release or replaced with an alternative immunity mechanic.)
  

✅ Bug Fixes

• Fixed a bug where guild leaders could promote themselves (unintended behavior).
  
  
• Found an issue? Report it on our Discord: https://discord.gg/FGUEEj6k7k
  

⚠️ Beta Version Notice
This update, v1.3.5, serves as the 1.4 Beta.
Whenever we introduce a large set of features, we release a beta version ending in .5.
For example:

• 1.3.5 = Beta for 1.4
  
  
• 1.4.5 = Beta for 1.5
  And so on...
  

Some features in beta may not work as intended and are subject to feedback and revision.

❤️ Thank You!
Thank you for using a plugin developed by Frostline Solutions LLC.
Crafted with care by the Frostline Dev Team, delivering quality features around the clock for the best experience possible.

# GuildWars Plugin - Patch Notes

## Version 1.3 - May 15, 2025

### New Features
- **Guild Chat System**:
- Added `/gchat` command (aliases: `/gc`, `/guildchat`) for guild-only communication
- Configurable chat format with guild name, role, and player name
- Role-specific colors (Leader: red, Officer: blue, Member: green)

- **Customizable Terminology**:
- Added ability to rename "guilds" to other terms like "factions", "clans", etc.
- New configuration option: `general.group-term` in config.yml
- Messages automatically update to use the custom term

- **Enhanced Player Experience**:
- Guild information displayed when players join the server
- Role-specific tags shown in chat

### Improvements
- **Minecraft Version Support**:
- Added compatibility with Minecraft versions 1.17 through 1.21.5
- Updated API dependencies to support a wider range of servers

### Bug Fixes
- Fixed Guilds not deleting when using the `/guildadmin delete` command or `/guildadmin delete <guildname>` command
- Report any bugs at https://discord.gg/FGUEEj6k7k