Arcanum | SMP Spell and Magic v1.1.0

Dependencies​

Required​

• Java 17 or newer — https://adoptium.net/
  (Java 21+ required by Paper 1.20.5+; Java 25+ required by 26.x)
• Paper, Spigot, or CraftBukkit — https://papermc.io/downloads/paper (Paper recommended)
  Live-tested clean on Paper 1.18.2, 1.20.6, 1.21.4, 1.21.11, 26.1.2 and Spigot 1.18.2, 1.21.4
• Minecraft version: 1.18.0 through 26.1.x

Optional integrations​

• Any anti-cheat — NoCheatPlus, Vulcan, Matrix, Spartan, etc.
  Some spells produce client-visible effects that look like cheat triggers to a strict anti-cheat — sudden velocity changes, short flight, speed/invisibility buffs, teleport, and temporary block placement. Either grant casters the appropriate anti-cheat bypass permission, or whitelist Arcanum's permission node arcanum.use in the anti-cheat's exemption list. No anti-cheat false-positive has been observed across the tested versions when permissions are set up.
• WorldGuard — https://dev.bukkit.org/projects/worldguard
  Region-safe out of the box. Block-modifying spells use vanilla Block.setType(...) — these are temporary placements that bypass BlockPlaceEvent, so they will NOT trip a build-deny region. If you want spell block changes to respect region build flags, run Arcanum behind a wrapper plugin that re-fires the event (out of scope for v1; on the roadmap).
• CoreProtect — https://www.spigotmc.org/resources/coreprotect.8631/
  Note that for the same reason as above, spell-driven block changes do NOT auto-log to CoreProtect's block-place table — they don't fire BlockPlaceEvent. The blocks revert on their own after the spell duration so there's nothing for CoreProtect to roll back anyway. Spell-page pickup, item drops, and player teleports log normally through CoreProtect's default listeners.
• LuckPerms / PermissionsEx / GroupManager — https://luckperms.net/
  Standard permission nodes: arcanum.use (default: true — anyone can cast known spells), arcanum.admin (default: op — admin commands + learning bypass + cooldown bypass), arcanum.give, arcanum.reload, arcanum.nocooldown. Set them per-rank in your perms plugin.
• EssentialsX / EssentialsXChat — https://essentialsx.net/
  Chat-cast listener runs at EventPriority.LOW and calls event.setCancelled(true) on a match, so EssentialsXChat (which formats at NORMAL) never sees a cancelled chat event — cast lines never appear in formatted public chat. Players' regular non-mantra chat flows through Essentials' formatter normally.
• DiscordSRV — https://www.spigotmc.org/resources/discordsrv.18494/
  Same priority-LOW cancel means cast attempts don't bridge to Discord. Non-mantra chat still relays. Permission-gating works through DiscordSRV's standard role-to-permission mapping.
• ItemsAdder / Oraxen / Nexo — custom-item plugins
  Spell pages and stamped scrolls use vanilla PAPER plus a namespaced PersistentDataContainer key. No collision with custom-item PDC scanners. Stamped scrolls won't be mistaken for any custom item.
• Citizens — https://www.spigotmc.org/resources/citizens.13811/
  Compatible. NPCs don't fire AsyncPlayerChatEvent so they can't accidentally chat-cast, and the spell-page right-click listener checks EquipmentSlot.HAND which NPC interaction events don't satisfy.