Server owner's guide

Fast travel for DayZ with hubs you place (people or objects), destinations you define, and payment in whatever money your server uses. No other mod required. Everything is set up in three small text files; this guide explains every line in plain language, with the example set the mod writes for you on first start.

1. Install in five minutes

1. Subscribe to the mod on the Workshop (or copy the @EDZ_FastTravel folder next to your other mods).
2. Add @EDZ_FastTravel to the -mod= list of your server and to your clients' mod list. It is a client + server

mod: players need it too, like any mod that adds a menu.

1. Copy the .bikey from @EDZ_FastTravel\keys into your server's keys folder.
2. Start the server once. The mod creates profiles\EDZ_FastTravel\ with three files:

1. Open Settings.json, put your own ID into AdminUIDs (Steam64 or the hashed DayZ ID, either works), then

restart or use the Admin tab's reload command. You now see the Admin tab in game.

The files the mod writes are a complete working example for Chernarus (the trader docks on the east coast). On any other map you move the positions or replace them with your own, see section 6.

Every line in the files has a // comment explaining it. Comments are ignored by the mod, so you can leave them, edit them or delete them. 1 means on, 0 means off.

2. How a trip works for a player

1. The player walks up to a hub and presses F (the prompt reads "Talk", "Board", whatever you set per hub).
2. The menu opens: a list of destinations with prices on the left, a card with details on the right. Destinations the

player cannot take yet say why: too expensive, an item is needed, not discovered yet, on cooldown.

1. Travel closes the menu and a countdown appears at the bottom of the screen. Walking away or taking damage cancels

it and nothing is charged.

1. At zero the server checks everything again, takes the money and any required item, moves the player to one of the

destination's arrival spots, and the screen fades to black.

1. The screen stays black until the player has actually arrived and the terrain around them has had a moment to load,

then fades back in. A protection timer counts down on screen; the player cannot be damaged until it ends.

Money and items are taken only at the very end, after the re-check. A cancelled or interrupted trip never costs anything, so there is nothing to refund and nothing to exploit.

3. Settings.json

// ---- money ----
"CurrencyName": "Rubles",
"Currency": [
  { "ClassName": "Money_Ruble1", "Value": 1 },
  { "ClassName": "Money_Ruble100", "Value": 100 }
],
"GiveChange": 1,

// ---- the trip ----
"CountdownSeconds": 10,
"FadeSeconds": 1.5,
"ArrivalHoldSeconds": 2,
"CancelMoveDistance": 3,
"CancelOnDamage": 1,
"CombatLockSeconds": 20,
"CooldownSeconds": 0,
"ProtectionSeconds": 10,
"InteractDistance": 4,
"AllowBleeding": 0,
"AllowRestrained": 0,

// ---- discovery ----
"DiscoverFirst": 0,
"DiscoveryRadius": 150,
"DiscoveryCheckSeconds": 10,

// ---- messages, logging, admins ----
"ShowFunds": 1,
"AnnounceArrivals": 0,
"LogTravel": 1,
"DefaultPrompt": "Fast travel",
"AdminUIDs": ["76561190000000000"]

4. Hubs.json

A hub is a place where the menu opens. It is either an NPC (a survivor body you dress) or an object (any object class in the game: a sign, a radio, a boat, a bus wreck, a building placed with the DayZ Editor).

{
  // ---- Boatman ----
  "ID": "boatman",
  "Name": "Boatman",
  "Type": "npc",
  "ClassName": "EDZ_FastTravelNPC_Kaito",
  "Spawn": 1,
  "Position": [13553.5, 3.07, 6291.94],
  "Orientation": [-83, 0, 0],
  "Clothing": ["Mich2001Helmet", "NVGoggles", "USMCJacket_Woodland", "HighCapacityVest_Olive", "TacticalGloves_Green", "USMCPants_Woodland", "MilitaryBelt", "CombatBoots_Black", "CoyoteBag_Green"],
  "InHands": "AK74_Black",
  "InHandsAttachments": ["Mag_AK74_30Rnd", "AK_PlasticBttstck_Black", "AK74_Hndgrd", "KobraOptic", "AK_Suppressor"],
  "Prompt": "Talk",
  "Greeting": "The sea is calm today. Where to?",
  "Icon": "Boat",
  "Destinations": ["svetloyarsk", "berezino", "chernogorsk"]
}

NPC faces: Boris Cyril Denis Elias Francis Guo Hassan Indar Jose Kaito Lewis Manua Niki Oliver Peter Quinn Rolf Seth Taiki (men) and Baty Eva Frida Gabi Helga Irena Judy Keiko Linda Lina Maria Naomi (women), used as EDZ_FastTravelNPC_Boris and so on. Plain EDZ_FastTravelNPC is Mirek. The NPCs cannot be damaged, looted or moved.

Several objects of the same class: each hub has its own position, and the prompt only appears on an object of that class standing within 3 metres of a hub's position. Three identical trail boards in three places are three hubs with three destination lists. Keep hubs more than 6 metres apart.

5. Destinations.json

{
  // ---- Skalisty Island ----
  "ID": "skalisty_island",
  "Name": "Skalisty Island",
  "Description": "Find it on foot once; after that, one crossing every ten minutes.",
  "TransportName": "Boat",
  "Price": 2500,
  "RequiredItem": "",
  "RequiredCount": 1,
  "ConsumeItem": 1,
  "Arrivals": [
    [13408.6, 1.4, 2848.6]
  ],
  "ArrivalOrientation": [0, 0, 0],
  "CountdownSeconds": -1,
  "ProtectionSeconds": -1,
  "CooldownSeconds": 600,
  "DiscoverFirst": 1,
  "Enabled": 1,
  "ArriveMessage": ""
}

6. Building your own map of hubs: the Admin tab

Everything can be typed into the JSON, but positions are easier to take from inside the game. With your ID in AdminUIDs, open any hub and switch to the Admin tab. Type a command (or pick one from the list) and press Run.

A typical session: walk to the spot where a destination should drop players, adddest; walk to where the NPC should stand, addhub; link them; then open Hubs.json and give the NPC clothing, a prompt and a greeting; reload.

7. Tips

• Money from another mod: list its classes in Currency. A note's Value is simply what one of it is worth. The mod does not care which mod the notes come from.
• Tickets: use RequiredItem with ConsumeItem 1 and any item you already have on the server, or an item from your own pack. A pass that is kept is ConsumeItem 0.
• No fades at all: FadeSeconds 0.
• Instant travel: CountdownSeconds 0 globally or per destination.
• Discovery per place: leave the global DiscoverFirst at 0 and set DiscoverFirst 1 on the special places.
• Players lose nothing on a failed trip: payment and items are taken after the final check, in the same server frame as the move.
• Log: Travel.log has one line per trip with the player, hub, destination and price. Each player's discovered places and trip counts are in Players\<id>.json.

8. If something does not work

All of the mod's lines in the server log start with [EDZ_FastTravel].

What the player sees on a trip

After Travel the menu closes and the countdown appears in the centre of the screen; walking away or taking damage cancels it and nothing is charged.

On arrival the screen stays black until the player is really there and the terrain has loaded, then fades in while the protection timer counts down.