CloudEnchants Pro

Players memorize vanilla enchantments within their first week on a server. Sharpness, Unbreaking, Silk Touch: everyone knows the ceiling, and nobody is surprised by it anymore. CloudEnchants Pro raises the ceiling: 46 original enchantments for melee weapons, bows, armor, and tools, each with its own mechanic rather than a cosmetic line in the lore. The plugin's internal name is CloudCustomEnchants, like the other Cloud plugins in the lineup; it's built for Paper/Spigot 1.19.4.

This is not a couple of flashy abilities for a screenshot but a whole system: enchantment books, an anvil with its own result calculation, a built-in store, drops from chests and mobs, admin commands, and a config where the numbers for every level of every enchantment are set separately. The second level doesn't have to be exactly twice as strong as the first.

A system, not cosmetics

The enchantment is stored right in the item, in the PersistentDataContainer (PDC), and survives renaming and any inventory manipulation. The lore line and the glow on the item are rebuilt automatically on every change.

• The main difference of the Pro approach from ordinary "enchanting" plugins: every level has its own numbers, set by hand in the config rather than computed by a formula.
• Single-level enchantments (max I) are written in the lore without a number, just "Filter"; multi-level ones always get a Roman numeral, even at the first level ("Vampirism I").
• The plugin adds the glint itself only if the item has no vanilla enchantment yet: it attaches a hidden Fortune level and hides its text with the HIDE_ENCHANTS flag. If the item is already enchanted with vanilla enchantments, the glint is already there and the plugin doesn't interfere.
• 5 rarity categories, from common to legendary, each with its own weight for random drops and its own book label color.
• Three independent balance caps: the limit of custom enchantments per item (max-custom-per-item), the limit of enchantments of one category per item (max-per-category), and incompatibility groups (conflicts). The config already contains commented-out example pairs ("Monster Crusher" + "Last Survivor", "Vampirism" + "Life Drain"), and all you need is to uncomment them. By default all three caps are off, so in theory nothing stops you from putting all 14 melee enchantments on one sword.
• Config changes are picked up with the /ce reload command without a server restart, including new levels, limits, and conflict groups.

The anvil: how the result is calculated

Slot 0 is the item, slot 1 is the book. If an ordinary book or something not from CloudEnchants is put in the second slot, the plugin doesn't interfere at all and the anvil works like vanilla (repair, renaming, regular enchants). The plugin recognizes its own recipe by a hidden tag in the book's PDC, and from there it calculates the result entirely by itself, since vanilla doesn't know such a recipe.

• The item type must fit the enchantment's target, otherwise there is no result.
• If the item doesn't have the enchantment yet, limits (per item, per category) and conflicts are checked. Upgrading an enchantment that's already applied doesn't go through these checks again.
• Books and items of the same level combine into +1, as in vanilla. Different levels take the higher one, and the lower one is wasted. If the result doesn't change, the anvil honestly shows "nothing to apply" instead of charging XP for nothing.
• The XP cost for applying: anvil-cost-per-level (5 by default) × the resulting level. Raising an enchantment to level II costs 10 XP, and a finished II to III costs 15: the higher the level, the more expensive each next step. It's free in creative mode.
• Shift-click puts the result straight into the inventory; a regular click requires a free cursor.

Where books come from

Vanilla chests

Through LootGenerateEvent, the plugin mixes books into regular loot generation. It works in any world, on top of vanilla tables, without replacing anything by hand.

Drops from mobs and blocks

Separate flexible rules (drops: in the config) attach a book to killing a vanilla mob, a MythicMobs boss, or mining a block. MythicMobs is connected through a soft hook via reflection: if the plugin isn't on the server, a rule with the mythicmob trigger simply never fires, and there is no error. Two rules are enabled out of the box: a zombie drops a random book to the killing player with a 3% chance, and a wither skeleton drops a rare book outright with a 10% chance. Next to them in the config are commented-out templates for "any mob" with a ghostly 0.5% chance, for a drop from a specific block (diamond ore), and for a MythicMobs boss, enabled by uncommenting one line. For crates, battle passes, donation stores, and NPCs from other plugins, there is direct giving with a single console command, with no dependency on events at all.

Store for PlayerPoints

The /ce shop command opens a GUI: 4 category icons (sword, bow, chestplate, pickaxe). Clicking a category opens a page with the books of that category (the size adjusts to their number), and a left click on a book immediately deducts points and gives a level I book. The store doesn't sell higher levels; those are obtained only by combining on the anvil. The wallet is exclusively PlayerPoints via reflection; if the plugin isn't there, the store honestly replies that it's unavailable instead of failing with an error.

There are only two legendary enchantments out of all 46: Headshot (bow) and Lockpicker (tool). The weight determines the chance in any random drop: the whole store assortment, drops, and chests. A random book also has a shifted level: with a 35% chance per step, the book goes one level above its minimum, so level I books dominate in circulation, and top levels are almost always the result of the anvil, not luck.

Melee enchantments (14)

Sword and axe, from vampirism and crowd control to plain but tangible hit power. Almost all 14 attach to both a sword and an axe; the exceptions are Corrosion (sword only) and Flyswatter, whose target is stated as "sword or bow", the only enchantment in this category that can also be put on a bow.

Bow enchantments (10)

All ten are stated with the target "bow", but in fact it's a bow or a crossbow: the vanilla shoot event the plugin subscribes to fires for both, so the books fit and work the same on a bow as on a crossbow.

"In the head" for Headshot is not a hitbox but a height: it counts if the arrow, at the moment of impact, is no lower than about 0.3 blocks below the victim's eyes. Headshot's bonus damage to mobs and Shockwave's in-flight damage are both off by default on purpose, so as not to break bosses or turn the bow into a scythe; both are turned on with a number in the config.

Armor enchantments (12)

Pro flexibility is most visible here, with a caveat: some effects stack across all 4 worn pieces, each by its own level, while others (Glutton, both "eternal" ones, fire resistance) are potion effects and don't stack but take the maximum among what's worn. So enchanting all 4 pieces with Eternal Strength is pointless: one piece gives the same result as all four.

Mega Protection with an 80% cap looks formidable, but on the default numbers it's unreachable even in theory: five levels on all 4 pieces give only 5×4 = 20% reduction. The headroom to the cap is room for future balancing, not a mistake. Resilient, on the other hand, delivers a noticeable number right away: level IV on all 4 pieces is +16 HP, a full 8 extra hearts on top of the normal health bar.

Tool enchantments (10)

Pickaxe, axe, hoe, and universal: they save hours of farming without turning mining into cheating. Every effect has an explicit cap (a block limit per use, a chance, a multiplier), and area enchantments honestly fire a real BlockBreakEvent for each extra block, so if WorldGuard is installed, the region will stop them the same way it stops manual mining.

A nuance for the admin: the wear setting per extra block (durability-per-block) physically sits in the Drill section but is applied to all three area enchantments at once: Drill, Ore Breaker, and Lumberjack. You can't set different values for them in the current version, since it's a shared switch.

How to build top-tier gear

There are no limits on the number of enchantments by default; only common sense holds you back, plus the fact that some armor buffs don't stack. Here are several working builds for specific tasks.

Dueling sword

Vampirism (healing from damage) + Backstab (a bonus from behind) + Combo (a damage burst on the 4th consecutive hit) + Confusion (knocks the victim's hand slot) + Withering (damage over time). All five are in the "weapon" category with no conflicts between them by default, and the target for all is "sword or axe", so it also works on an axe.

Anti-crowd weapon

Monster Crusher + Last Survivor + Whirlwind Strike: a build for mob farming and defense against a crowd rather than for dueling: a multiplier against monsters, a bonus for each entity nearby, and a chance for an area hit on a charged attack. It's stronger on an axe, which has higher base damage, so Whirlwind Strike hits harder too.

Sniper bow

Falcon Eye (a bonus at range) + Stun (control on hit) + Explosive Shots or Shockwave (area finishing). Homing isn't required here: its target search radius is 12 blocks, so it's more useful on a bow for close and medium range, where not missing an agile target matters, than at long range, which Falcon Eye already boosts.

"Tank" armor

Mega Protection, Recovery Formula, and Resilient on all 4 pieces at once, since they stack. Plus any single piece with Eternal Strength or Eternal Speed: a second, third, and fourth copy of the effect adds nothing because the effect doesn't stack, and would only waste a slot. The result at max levels: +80% regeneration speed, +16 HP, up to 20% reduction of any damage, and that's still not the 80% cap, so the admin has room for future buffs.

Mining combine

Drill II (5x5) + Ore Breaker + Lucky Miner II + Smelting + Experienced III + Magnet: all have the target "pickaxe", there are no conflicts, and they go on one pickaxe together. Separately for the axe: Lumberjack + Experienced + Magnet; separately for the hoe: Wide Hoe + Farmer. Lockpicker, since its target is "weapon or tool", is handy to put on any secondary item so it doesn't take up a "pricey" slot on your main tool.

Commands

Examples: /ce book vampirism 3 Vitaliy gives player Vitaliy a "Vampirism III" book; /ce random Vitaliy epic gives a random epic book without choosing a specific enchantment; /ce apply drill 2 immediately puts "Drill II" on the held item, with no anvil and no XP. Tab completion suggests enchantment ids, available levels (up to the max of a specific enchantment), online player names, and rarity ids, so you won't have to type blind. The command has the aliases enchants, кз, зачар, зачарование.

Permissions

Configuration and compatibility

Built for Paper/Spigot 1.19.4 (api-version 1.19). Three plugins are declared in softdepend, but only one is truly used: PlayerPoints is connected through reflection, and the whole plugin lives without it, with only the store failing. WorldGuard is not a separate hook but a natural consequence of area enchantments and Lockpicker firing real game events that WorldGuard already listens to and can cancel. Vault, however, is declared in softdepend but used nowhere in the code: there is no real economy hook for it, and all money logic goes only through PlayerPoints. MythicMobs is connected as softly as PlayerPoints, through reflection, with no mandatory dependency in the build.

• The limit of custom enchantments per item and, separately, per category (weapon/bow/armor/tool); unlimited by default, and the switch is already in the config.
• Incompatibility groups: any two enchantments can be declared mutually exclusive with one config line, and ready-made examples are already there, commented out.
• A list of worlds with custom enchantments fully disabled, for spawn, lobbies, and event maps.
• Rarity weights for random drops (store, drops, chests), a separate slider for each of the five rarities.
• The glint on enchanted items, XP spent at the anvil, and the sound and particles for each specific enchantment are all changeable in the config and picked up on the fly with /ce reload.

46 enchantments where every level is set by hand rather than calculated by a formula: this is not a list of abilities but a tool for tuning a server's balance to your own needs.