Traveler

ABOUT

Traveler adds a personal villager companion that follows you through your world, inspired by Terraria's Town NPCs.

Each player gets their own Traveler, who can be summoned using the Traveler Compass and controlled individually by its owner.

Travelers can follow you around, sit in a chosen location, attack hostile mobs when enabled, and use different selectable skins.

The mod also introduces a custom trading and progression system, allowing Travelers to level up, unlock new trades, gain XP, and restock their offers independently for each player.

Nearly every feature is configurable, including trades, combat behavior, progression, and how Travelers interact with players.

Q&A

Inspiration for the mod?

I took inspiration from Terraria's Town NPCs, especially the Guide, which follows the player, offers trades through a custom GUI, and like other Town NPCs can be assigned housing.

Where can I run this mod?

You can run this mod on both Client and Server side.

Does everyone need mod installed to join my Server?

Yes. Both integrated or dedicated server needs to have mod installed and also every player who joins that server needs to have mod installed.

Will mod register custom items for trade?

Yes, any items will work.

Mechanics?

Use Traveler Compass to summon Traveler.

It will follow you around, by shift + right clicking you can switch between sitting and following positions, placing him anywhere in the world as you wish.

You can enable/disable Traveler's ability to attack hostile mobs by shift + left clicking.

Various skins for your traveler on you to select by left click.

Every player gets it's own Traveler and each Traveler receives commands from it's owner. Custom leveling, command, xp, restock for all individuals.

/traveler reset
Resets all data of all Travelers to default (all progression).

What software was used for mod's creation

It was created in Eclipse IDE.

CONFIG v1.1

Configuration Options

There are three config files inside config/ called traveler-level1.json, traveler-level2.json, traveler-level3.json. Each file holds items that will be unlocked as Traveler progresses. Here is example how they can look like:

{
  "firstJoinCompass": true,
  "travelerAttack": true,

  "trades": [
      {
            "input1": {
              "item": "minecraft:emerald",
              "count": 1
          },
            "input2": {
              "item": "minecraft:cobblestone",
              "count": 20
          },
            "output": {
              "item": "minecraft:stone_sword",
              "count": 1,
              "enchantment": "minecraft:unbreaking",
              "enchantmentLevel": 2
          },
              "maxUses": "3",
              "xp": 1,
              "priceMultiplier": 0.05
      },

      {
            "input1": {
              "item": "minecraft:diamond",
              "count": 10
          },
            "output": {
              "item": "minecraft:netherite_sword",
              "count": 1,
              "enchantments": [
                {
                  "enchantment": "minecraft:sharpness",
                  "enchantmentLevel": 5
                },
                {
                  "enchantment": "minecraft:unbreaking",
                  "enchantmentLevel": 3
                }
              ]
          },
              "maxUses": "2",
              "xp": 2,
              "priceMultiplier": 0.05
      }
}

"firstJoinCompass" gives all newcomers the Traveler Compass used for teleporting your personal Traveler, "travelerAttack" ability for Travelers to attack hostile mobs.

"input1" required trade input option, "input2" optional trade input option, "output" required output after trade.