MartianEnchantments

⚠️ Experimental Plugin Notice

MartianEnchantments is currently experimental.
Early versions may contain bugs, unfinished features, or behavior changes between updates.

This plugin is under active development. If you encounter issues or have suggestions, please report them on GitHub.

---

General

MartianEnchantments is a custom enchantment system for PocketMine-MP , inspired by plugins like AdvancedEnchantments, but rewritten from scratch for modern PocketMine versions.

It allows server owners to create, modify, and manage custom enchantments entirely through configuration, without relying on vanilla or PocketMine’s built-in enchantment system.

---

Key Features

• Fully config-driven enchantments (enchantments.yml)
• Create, edit, or remove enchantments without code changes
• Custom triggers such as ATTACK, DEFENSE, HELD, EFFECT_STATIC, and more
• Per-level chance, cooldowns, conditions, and effects
• Supports multiple effects per enchantment level
• Uses a custom NBT-based enchantment system
• Not tied to vanilla or PM enchant mechanics

---

Triggers & Effects

Enchantments activate through triggers that define when they run (e.g. attacking, defending, holding an item, wearing armor).

This version includes 9 implemented effects :

• ACTION_BAR
• ADD_AIR
• ADD_FOOD
• ADD_HEALTH
• ADD_POTION
• BLOOD
• BURN
• DISABLE_ACTIVATION
• STEAL_HEALTH

More triggers and effects can be added in future updates.

---

Commands & Items

The plugin includes multiple enchantment-related commands.

Some enchantment-related items exist, but full item functionality is still being expanded and will be improved in upcoming releases.

---

For Developers

MartianEnchantments includes utility methods intended for developers, such as:

• Custom enchantment management
• Enchantment extraction from items
• Trigger execution helpers

This makes it easier to integrate or extend the enchantment system.

---

Planned Updates

Future updates may include:

• Additional effects
• Additional triggers
• Enchantment GUIs (e.g. /enchanter)
• Expanded enchantment item functionality
• More condition types

All new features will be released incrementally.