XMAS Weapons v1.0

XMAS Weapons - Premium Christmas Plugin for Minecraft

Transform your Minecraft server into a winter wonderland with XMAS Weapons! This premium Christmas plugin features 15 custom weapons and tools with unique abilities, stunning visual effects, comprehensive statistics tracking, and full customization options. Perfect for holiday events, RPG servers, and seasonal gameplay.


Complete Feature List

15 Unique Christmas Items
Every weapon and tool includes custom abilities activated with Shift + Right Click, plus passive effects that trigger automatically. All items feature custom model data support, enchantment glints, and fully customizable names and lore.

Combat Weapons:
• Christmas Sword - Ice Vortex ability creates a freezing storm around you, dealing damage and slowing enemies. Passive: Night Vision effect
• Christmas Axe - Snow Tornado pulls enemies toward you while dealing damage. Passive: 15% Lifesteal on all attacks
• Christmas Bow - Shoots snowball projectiles instead of arrows. Ability: Snowball Cloud rains projectiles for 10 seconds
• Christmas Crossbow - Fires snowball volleys. Ability: Gift Volley shoots multiple snowballs at once
• Christmas Hammer - Shockwave Wall ability launches enemies into the air with a powerful ground slam
• Christmas Scythe - Teleports you to where you're looking and grants invisibility. Passive: Speed boost on snow/ice blocks
• Christmas Spear - Ice Lance ability with 3-charge system. Passive: Permanent Speed II effect
• Christmas Staff - Hot Chocolate ability heals and buffs nearby players. Passive: Regeneration aura for allies
• Christmas Trident - Lightning Chain jumps between up to 8 enemies. Passive: Speed aura for nearby teammates
• Christmas Greatsword - Star Comet dash propels you forward at incredible speed. Passive: Strength I effect

Functional Tools:
• Christmas Pickaxe - Freezes water in 5 block radius. Passive: Haste II when mining ice/snow
• Christmas Hoe - Elf Harvest auto-harvests and replants 15x15 area. Passive: Bonus crop drops and auto-replanting
• Christmas Shovel - Snow Blast launches nearby enemies upward. Passive: Haste III on snow, instant snow clearing
• Christmas Fishing Rod - Summons large gift from sky. Passive: Catches presents instead of fish
• Christmas Shield - Ice Fortress traps enemies in ice cage. Passive: Freezes attackers on perfect block

150+ PlaceholderAPI Placeholders
Full integration with PlaceholderAPI for scoreboards, holograms, and chat:
• Player stats: %xmasweapons_kills%, %xmasweapons_deaths%, %xmasweapons_kdr%
• Formatted numbers: %xmasweapons_kills_formatted% (1,234)
• Ability usage: %xmasweapons_ability_<item>%
• Top rankings: %xmasweapons_top_kills_<rank>%
• And 140+ more placeholders for complete customization

WorldGuard Integration
Seamless region protection compatibility:
• Block weapon abilities in protected regions
• Respect PvP flags for player damage
• Honor block-break/block-place permissions
• Mob-spawning restrictions for abilities
• Configurable per-world enable/disable

Multi-Language Support
Included languages: English (default), Polish
• All messages, lore, and action bars translatable
• Easy to add new languages - copy lang/en.yml and translate
• Color code support with & formatting
• Placeholder support in all messages

100% Customizable Configuration
7 separate YAML files for complete control:

1. config.yml - Core settings, database, integrations, auto-save intervals
2. items.yml - Item names, lore, materials, custom model data, base damage
3. abilities.yml - Cooldowns, damage values, durations, ranges, particle amounts
4. particles.yml - Particle types, counts, speeds, colors for every effect
5. sounds.yml - Sound effects, volumes, pitches for all abilities
6. loot-tables.yml - Custom drop tables for mob kills with Christmas weapons
7. worlds.yml - Enable/disable abilities per world, blacklist/whitelist mode

Every aspect is customizable without touching code!

---

Commands & Permissions

Commands:
• /xmas give <item> [player] - Give Christmas items
• /xmas reload - Reload all configurations
• /xmas stats [player] - View player statistics
• Aliases: /cw, /christmasweapons

Permissions:
• xmasweapons.give - Give items to players
• xmasweapons.reload - Reload configurations
• xmasweapons.use - Use Christmas items (default: true)
• xmasweapons.use.<item> - Permission per specific item
• xmasweapons.stats - View own statistics
• xmasweapons.stats.others - View other player stats

---

Frequently Asked Questions

Q: Is everything customizable?
A: Yes! Names, lore, materials, custom model data, abilities, damage, cooldowns, particles, sounds, and more. 7 config files provide complete control.

Q: Will this cause server lag?
A: No. Plugin uses async operations, efficient caching, and optimized algorithms. Tested with 50+ players with no TPS drop.

Q: Do I need PlaceholderAPI?
A: Optional but highly recommended for scoreboard/hologram integration. Plugin works without it.

Q: Does WorldGuard integration work?
A: Yes. Full region protection support - abilities respect PvP, block-break, and spawn flags.

Q: Are item textures included?
A: No, textures are not included. Plugin uses custom model data - add your own resource pack. Default items have vanilla textures with custom enchantment glints.

Q: Can I add more languages?
A: Yes! Copy lang/en.yml, rename to your language code (e.g., es.yml, de.yml), translate all text, set default language in config.yml.

Q: Can I disable specific abilities?
A: Yes. Set enabled: false for any item in items.yml, or use per-item permissions.

Q: Does it work with other plugins?
A: Yes. Compatible with most popular plugins: EssentialsX, Vault, LuckPerms, Citizens, MythicMobs, etc.

Q: Can I use this on multiple servers?
A: License covers one server network. Contact for multi-server licensing.


Make this Christmas special on your server - Get XMAS Weapons today!

Join our discord server for support!