Skip to content
Nathan Wolf edited this page Apr 11, 2026 · 5 revisions

Magic integrates with ValhallaMMO.

Valhalla profile levels are exposed as Magic attributes. Skill and Level XP is exposed as a Magic currency.

NOTE: All of the examples in here will go in new files that you create. Eventually there will be a valhalla example to do all of this for you.

Disable path-based progression

For now, the best approach is to disable path progression and let Valhalla handle leveling up.

In plugins/Magic/paths/default.yml put:

default:
  allow_property_overrides: false

This will prevent paths from overriding mana max and regen.

Using Valhalla levels

Valhalla levels can be read as attributes, and so used in class, spell and other parameters.

For example, if path progression is disabled you will want players to gain mana on level up.

In plugins/Magic/classes/mage.yml put:

mage:
   path:
   mana_max: valhalla_level_alchemy * 10 + 50
   mana_regeneration: valhalla_level_alchemy * 2 + 5

In this example we're using the alchemy profile and skill, but in the future there will be a builtin magic profile and corresponding skill.

Awarding Valhalla XP

Spells can award Valhalla XP instead of Magic SP, so the player can level up by casting spells.

In plugins/Magic/config/currency.yml put:

builtin_currency:
  sp:
    replacement: valhalla_xp_alchemy

Test that variables are working

You should see a message on startup saying Valhalla integration is working, listing all of the available attributes and currencies. If you want, you can use a spell to test this:

In plugins/Magic/spells/valhalla.yml put:

valhalla:
  actions:
    cast:
      - class: Message
        message: "Your Valhalla alchemy level is $valhalla_level_alchemy with $valhalla_level_alchemy XP"
  parameters:
    target: "self"

Profile and skill

The magic profile and skill can be disabled.

In plugins/Magic/config/valhalla.yml put:

valhalla:
  profile:
    enabled: false

TODO

  • Add a builtin magic profile and skill
  • Add spell perks and other buffs
  • Add a valhalla example that turns the above on.

Clone this wiki locally