Pixel Dream StudiosWiki

Datapacks

The data files behind mercenaries' personalities, looks and titles, and where they go.

These pages are for modpack authors, datapack authors, and other modders who want to extend Magic Realms' mercenaries with their own personalities, skins, or named characters.

Almost everything personality and appearance-related in Magic Realms is datapack-driven.

The config options are on the Config page.

All of the following live under data/magic_realms/:

  • data/magic_realms/
    • mercenaries/
      • personality/
        • archetypes/ one .json per archetype
        • fixed_personalities/ one .json per named character
        • hobbies/ one .json per hobby
        • archetype_interactions/ one .json per archetype pair relationship
      • skin_parts/ one .json per skin / clothes / eyes / hair piece
      • skin_presets/ one .json per complete preset texture
      • titles/ one .json per earnable title
      • bandit_profiles/ one .json per bandit (hostile mercenary) preset
    • tags/
      • … spell tags, item tags, biome tags, etc.
  • data/<your_namespace>/ outside the mercenaries tree
    • neoforge/
      • biome_modifier/ one .json per bandit spawn rule

Every catalog is loaded via a vanilla SimpleJsonResourceReloadListener, so /reload will pick up changes without restarting the server (with the caveat that already-spawned mercenaries keep whatever they originally rolled - only newly spawned mercenaries see the updated catalog).