Download

Adventurer's Guide Hub

Configure the world-spawn guide NPC and its hub menu

Overview

The Adventurer's Guide is a guide NPC the mod spawns automatically at your world spawn point. Talking to it opens a two-panel hub: a grid of one-click icon tiles on the left, with the main board's active bounties previewed on the right, so a player can see their live contracts and jump anywhere from one place. The first time a player talks to the guide it runs a short guided welcome that introduces the whole mod before dropping them at the hub.

Hub settings live in mods/mmoskilltree/spawn-hub.json using an override-based system. The file only stores your customizations - defaults are built into the mod and auto-update with new versions. The guide role ships in the mod jar, so the spawn works with no content pack installed.

Override configmods/mmoskilltree/spawn-hub.json

Hub Tiles

The hub menu is feature-aware and only lists what your server has enabled. The left panel is a grid of icon tiles, each opening a section in one click:

  • Skills - your skill cards and leveling progress
  • Quests - your live quest log
  • Achievements - achievement chains and progress
  • Abilities - active abilities and bindings
  • Mastery - ability mastery nodes
  • Boosts - active XP boosts and tokens

When the relevant content is installed, the grid also adds a tile for every available bounty board plus the Token Shop, joined to the core tiles. The right panel previews the main board's active bounties with live progress when a bounty board is present. The hub self-gates which destinations it offers, so a server without those features simply shows the core tiles.

Guided Welcome Arc

The first time a player talks to the Adventurer's Guide it runs a short walkthrough that introduces the whole mod - skills and leveling, the skill tree, quests and achievements, abilities, mastery, currencies, bounties, the shop, and more - before dropping them at the hub. Each step shows a faithful preview of the matching screen built from the player's real data, so they know what to look for.

  • The arc offers a new player a short tutorial or a skip; both paths leave them with the Skill Menu Scroll, so the menu is always one item-use away.
  • It teaches the /xp command (and /skills) for opening the skills menu.
  • It only covers the features your server actually has turned on, and shows once per player automatically.
  • Players can re-open it any time with the "?" Help button tucked into the window header, also reachable from the left panel of the Skills menu.

The tutorial ships in the jar and works with no pack installed - breaking your first block hands over the Skill Menu Scroll automatically. With the free MMO Skill Quest Pack installed, finishing or skipping the tutorial opens the Emerald Wilds campaign, so the jar tutorial and the pack campaign read as one continuous start.

File Structure

{
  "schemaVersion": 3,
  "enabled": true,
  "role": "MMO_Hub",
  "worlds": ["default"],
  "offset": { "x": 2.5, "y": 0.0, "z": 0.0 },
  "yaw": 180.0
}
  • schemaVersion - Config format version (do not change)
  • enabled - Whether the guide auto-spawns at world spawn (default true)
  • role - The NPC role to spawn (default MMO_Hub, the jar-resident guide)
  • worlds - The worlds the guide auto-spawns in (default ["default"])
  • offset - Position offset from the world spawn point, in blocks
  • yaw - Facing angle in degrees
  • dialogue - Optional. The branching dialogue id press-F routes to (omitted by default; see below)

The Worlds List

The auto-spawn is restricted to the worlds named in worlds. The default ["default"] keeps the guide out of secondary worlds (creative, build, minigame) on a multi-world server. World names match the in-game world name:

  • Add more world names to the list to spawn the guide in each of them.
  • A single "*" entry spawns it in every world.
  • An empty list [] disables the auto-spawn entirely, so you place the guide yourself.

The worlds gate covers the auto-spawn only. Manual placement with /mmonpc spawn and the in-world blocks are unaffected.

Welcome Dialogue Hook

The optional dialogue field routes the guide's interact key to a branching dialogue instead of opening the hub menu directly. When the key is unset the guide uses the jar-bundled mmo_hub_intro onboarding dialogue, so a fresh config shows the tutorial-or-skip welcome out of the box:

  • Unset (key absent) - Uses the jar default welcome dialogue.
  • An explicit id - Routes to that dialogue (for example, a content pack's).
  • Empty string "" - Disables the dialogue; press-F opens the hub menu directly.

This is a generic seam: the default id names a jar dialogue and any other id a pack's, with no campaign logic hardcoded. See the quests and quest-giver docs for how dialogues are authored.

Spawning and Management

The /mmonpc admin command spawns, lists, removes, and resets guide and quest giver NPCs:

  • /mmonpc spawn hub - Place the Adventurer's Guide at your location
  • /mmonpc list - List placed mod NPCs
  • /mmonpc remove - Remove a placed NPC
  • /mmonpc reset - Clear the once-per-world auto-spawn marker so the guide can respawn

The guide auto-spawns once per world (tracked by a per-world marker), so a server restart will not duplicate it. To relocate the guide, disable the auto-spawn or adjust the offset, then use /mmonpc to place it where you want.

Best Practices

  • Leave worlds at ["default"] on a multi-world server so the guide stays out of creative and minigame worlds.
  • Set enabled to false (or worlds to []) if you prefer to place the guide yourself with /mmonpc spawn hub.
  • Use the offset and yaw fields to nudge the guide off the exact spawn point and face it toward arriving players.
  • Leave the dialogue key unset to keep the built-in welcome, or set it to a pack dialogue to customize the greeting.
  • Back up spawn-hub.json before major changes.