Project MMO: Iron's Spells & Spellbooks Compat

This mod requires Project MMO and Iron's Spells and Spellbooks for Minecraft version 1.20.1.

Core Functionality

This compatibility mod enables the configuration of skill requirements for spell usage through world datapacks. If a player lacks the necessary skill level, they cannot activate the corresponding magic.

A distinctive feature is the ability to set different requirements for each level of the same spell. You can flexibly define which conditions should apply when activating charms through scrolls, spellbooks, or enchanted swords, and you can completely prohibit adding spells to the spellbook.

Additionally, the configuration settings include a healer experience system - players receive skill points when their healing spells cure other participants. This allows developing the specialization of healer or priest by helping team members.

Getting Started

The simplest way to create basic settings is to run the following command in the desired game world:

/pmmo_irons_compat genSpellData

This command automatically creates a datapack with standard settings for all available spells from Iron's Spells and Spellbooks. The generated JSON files can be edited according to your preferences by deleting configurations for unnecessary spells. The command can be used multiple times to update the list of available spells without losing already created settings.

After executing the command, let's take the fireball.json file as an example with the following content:

{
  "requirements": {
    "1": {},
    "2": { "magic":  5}
  },
  "default_requirements": {
    "magic": 10,
    "charisma": 2
  },
  "sources": [
    "scroll",
    "spellbook",
    "sword",
    "inscribe"
  ],
  "replace": true
}

Example of Mandatory Requirement Configuration

The "default_requirements" key sets general requirements for all fireball levels - magic level 10 and charisma level 2 are required to activate any strength level spell.

The "requirements" section allows defining specific conditions for particular spell levels. In the given example, the first-level fireball has no restrictions, while the second level requires magic level 5. All other levels remain under the influence of basic requirements.

Through the "sources" parameter, spell application methods that undergo skill checks are specified. In our example, restrictions apply when activating through scrolls, spellbooks, swords, and when attempting to add a spell to the spellbook. To exclude a specific usage method, simply remove the corresponding value from the sources list.

The "replace" flag resolves conflicts between datapacks when multiple setting sets can be applied to one spell simultaneously. A datapack with the value set to true takes priority over configurations with false, and with multiple active settings with true, the last loaded version remains in effect.

Configuration Flexibility

All listed elements are optional. If you need to set a requirement only for a specific spell level, the "default_requirements" section can be omitted from the configuration. For uniform requirements for all levels, keep only "default_requirements" by deleting "requirements". Without "sources", requirements cease to affect spell usage, making the configuration file practically meaningless.

Technical Capabilities

Special thanks to the developers of Project MMO and Iron's Spells and Spellbooks for technical support and access to source code, which enabled implementing compatibility without using additional tools.