Content Packs

Overview

Third parties can add or override MMO Skill Tree content - quests, achievements, conversations, placed NPCs, storefronts, contract boards, abilities, XP tuning and more - without writing any Java, by shipping a standard Hytale asset pack: a .zip (or folder) of JSON dropped into the server's mods directory. The engine discovers, loads, and merges your pack at server start.

Pack content lives in two trees, and which one a type belongs to is decided by who owns the engine that reads it:

• Server/ZiggfreedCommon/ - the shared library types: quests, achievements, achievement categories and point milestones, conversations, NPC placements and identities, currencies, storefronts, shelves, offers, boards, contracts, reward kinds, loot tables and feedback moments.
• Server/MMOSkillTree/ - everything this mod owns on its own: abilities and ability improvements, custom skills, bonus drops, XP maps, mob-kill XP, item and action requirements, boost templates, command rewards, mastery tracks, power-level tuning.

One pack may ship both trees. See ZiggfreedCommon: shared engines & files for the owner's view of the shared half.

Who this is for

• Server owners who want to customize content beyond the admin dashboard, and keep those customizations in a portable pack they can move between servers.
• Content creators shipping quest packs, class packs, or total conversions on CurseForge.
• Translators contributing new languages (see Translation Packs).

What packs can add

Each links to its entry in the Content Type Reference:

• Quests and achievements in the shared format (Server/ZiggfreedCommon/Quests and .../Achievements), plus achievement categories and point milestones as ordinary files.
• Conversations - what a character says.
• NPC placements - one file per NPC under Server/ZiggfreedCommon/NpcPlacements/, where they stand and what pressing F opens, managed live with /mmonpc list [--arg1=placements|structures|markers|channels] | enable | disable | reconcile.
• Currencies, storefronts, shelves and offers and boards of contracts - library types, so a wallet or a shop authored for this mod works for any mod that reads the same library.
• Bonus drops - the extra a broken block or a killed mob hands over, one row per file.
• Custom skills (Server/MMOSkillTree/CustomSkills) (Since 1.6.0)
• Abilities and ability improvements (AbilityMods) (Since 1.6.0), plus gear stats on items via native MMO_* stat modifiers
• Reward kinds - a payout kind of your own, declared as a file with a parameter list and one command line, no Java.
• Shared loot tables - a named table anything can point at, and a way to enrich a table somebody else shipped.
• Feedback moments - what a quest completion or an achievement unlock says, as JSON.
• Mastery tracks, and power-level formula tuning (read by the optional MMO Mob Scaling companion mod).
• XP maps, mob-kill XP, item and action requirements, boost templates, command rewards
• Translations (native Hytale .lang files, not a custom type)

What packs cannot add

• Skill-tree nodes (including SCHOOL_RESIST) - owner config only (skill-tree.json overrides), even though the reward type and the damage schools it targets are otherwise pack-referenceable.
• XP tokens - can be tweaked through config, but not created from pack data.

Reference packs

Real, production packs you can learn from, each demonstrating a different slice of the system:

Every pack above ships as a companion download alongside the mod on CurseForge - see Companion Mods & Content Packs for what each one needs installed and the install order.

Quick start

A content pack is a manifest plus JSON under one or both content trees:

MyMmoPack.zip
├── manifest.json
└── Server/
    ├── ZiggfreedCommon/
    │   ├── Quests/MyStudio/Dragons/Dragon_Hunt.json
    │   └── Achievements/MyStudio/Combat/First_Blood.json
    └── MMOSkillTree/
        ├── Control/MyMmoPack.json        (optional - per-type add/replace mode)
        ├── XpMaps/MyMmoPack.json
        └── BonusDrops/Dragon_Hoard.json

The manifest

Only Name is required and IncludesAssetPack must be true. No Main class is needed - this is a data-only pack.

{
  "Group": "YourStudio",
  "Name": "MyMmoPack",
  "Version": "1.0.0",
  "ServerVersion": "*",
  "IncludesAssetPack": true
}

Add your first quest

A shared-schema quest is one file, with no envelope and no Id field: the file is the quest, and its id is the filename, lower-cased. Put it in a namespace folder of your own so your files never sit beside somebody else's.

// Server/ZiggfreedCommon/Quests/MyStudio/Dragons/Dragon_Hunt.json
{
  "Name": "Dragon_Hunt",
  "Text":    { "TitleKey": "quest.dragon_hunt.title",
               "FlavorKey": "quest.dragon_hunt.flavor" },
  "Listing": { "Category": "main", "SortOrder": 10 },
  "Objectives": {
    "slay": { "Kind": "KILL_ENTITY", "Target": "Trork", "MatchMode": "CONTAINS", "Amount": 5 }
  },
  "Rewards": {
    "Claim": [
      { "Kind": "Mmo_Xp", "Params": { "Skill": "SWORDS", "Amount": "500" } }
    ]
  }
}

Rewards holds two lists. Auto lands the instant the quest settles; Claim - the default, used above - waits in the quest log until the player collects it. See the two buckets.

Install and verify

1. Zip the folder so manifest.json sits at the zip root - see Building the zip for the exact packaging rules, including the forward-slash entry-name caveat on Windows.
2. Drop the zip (or the unzipped folder) into your server's mods directory - the same place MMO Skill Tree itself lives.
3. Start the server.
4. Look for lines like these confirming the pack loaded:

[AssetPacks] Registered MMO content asset stores
[AssetPacks] Quest pack layer applied (1 entries, mode=add) - N quests effective

Where to go next

• Content Types & Merging - every pack-extensible type, how merging works, the Control file, and feature gating.
• ZiggfreedCommon: shared engines & files - which engines the shared library owns, where its content lives, and the owner files under mods/ziggfreedcommon/.
• Shared Schemas - the one Requires gate, prices, reward kinds, and the objective shape every type reuses.
• Quests & Bounties, Achievements, and Masteries - full field references.
• Dialogues & placed NPCs - conversations and the characters that carry them.
• Shops & Currencies - wallets, storefronts, shelves, offers, and the files that write a family of offers at once.
• Abilities and Gear stats - the ability and item-stat authoring surface.
• Template Extension - the extends / params DSL the remaining raw-payload types still use.
• Publishing & Translations - zip-building, translation packs, cosmetic packs, and security.