Configuration

Configuration

Journey stores all configuration in config/journey/. The main settings file is config.json, and each system has its own subdirectory for content files.

---

Directory Structure

On first start, Journey creates:

config/journey/
├── config.json              # Main server configuration
├── messages.json            # Customizable messages
├── npc_paths.json           # NPC path assignments
├── tasks/                   # Quest definitions
├── zones/                   # Zone configurations
├── levelables/              # Skill/progression systems
├── timelines/               # Scripted sequences
├── buffs/                   # Buff definitions
├── bounty_boards/           # Bounty board configs
├── global_tasks/            # Server-wide tasks
├── markers/                 # Quest markers
├── interactables/           # Interactive entities
└── paths/                   # NPC patrol paths

---

Main Configuration (config.json)

File: config/journey/config.json

{
  "debug": false,

  "subtask_separator_character": "<gold>┃</gold>",
  "task_description_separator_character": "<gold>┇</gold>",
  "subtask_description_separator": "<gold>╏</gold>",

  "quest_sidebar_title": "<gold>Quests",
  "task_description_max_length": 48,
  "subtask_description_max_length": 48,
  "max_tasks_shown": 2,
  "show_description_in_sidebar": false,

  "daily_reset_time": "00:00",
  "weekly_reset_day": "Monday",
  "monthly_reset_day": 1,
  "reset_time_zone": "UTC",
  "yearly_reset_date": "01-01",

  "completed_task_model": "minecraft:paper",
  "uncompleted_task_model": "minecraft:book",
  "back_button_model": "minecraft:arrow",
  "forward_button_model": "minecraft:arrow",
  "close_button_model": "minecraft:barrier",

  "journal_menu_title": "<blue>Journal",
  "journal_task_menu_title": "<blue>{task_name}",

  "server_name": "Server",
  "default_currency": "impactor:dollars",

  "levelable_mode": "multi_active",
  "levelable_max_count": -1,
  "levelable_switch_cooldown_seconds": 0,
  "levelable_respec_cost": 0.0,
  "levelable_respec_confirmation_required": true,
  "levelable_respec_currency": "impactor:dollars",

  "party_enabled": true,
  "party_max_size": 10,
  "party_task_sync_enabled": true,

  "global_tasks_enabled": true,
  "global_tasks_central_server": "",
  "is_global_tasks_central_server": false
}

---

Settings Reference

Debug

Setting	Type	Default	Description
debug	Boolean	false	Enable verbose logging for troubleshooting

UI Separators

Setting	Type	Default	Description
subtask_separator_character	String	<gold>┃</gold>	Separator between subtasks in the UI
task_description_separator_character	String	<gold>┇</gold>	Separator for task descriptions
subtask_description_separator	String	<gold>╏</gold>	Separator for subtask descriptions

Sidebar

Setting	Type	Default	Description
quest_sidebar_title	String	<gold>Quests	Title at the top of the sidebar
task_description_max_length	Integer	48	Max characters for task descriptions
subtask_description_max_length	Integer	48	Max characters for subtask descriptions
max_tasks_shown	Integer	2	Number of tasks shown in sidebar
show_description_in_sidebar	Boolean	false	Show task descriptions in sidebar

Journal UI

Setting	Type	Default	Description
journal_menu_title	String	<blue>Journal	Title for the journal menu
journal_task_menu_title	String	<blue>{task_name}	Title for task detail view
completed_task_model	String	minecraft:paper	Item icon for completed tasks
uncompleted_task_model	String	minecraft:book	Item icon for incomplete tasks
back_button_model	String	minecraft:arrow	Item icon for back button
forward_button_model	String	minecraft:arrow	Item icon for forward button
close_button_model	String	minecraft:barrier	Item icon for close button

Reset Times

These control when repeatable tasks reset.

Setting	Type	Default	Description
daily_reset_time	String	00:00	Time of day for daily resets (24-hour format)
weekly_reset_day	String	Monday	Day of the week for weekly resets
monthly_reset_day	Integer	1	Day of the month for monthly resets (1-31)
yearly_reset_date	String	01-01	Date for yearly resets (MM-DD)
reset_time_zone	String	UTC	Timezone for all resets

Economy

Setting	Type	Default	Description
server_name	String	Server	Display name for this server
default_currency	String	impactor:dollars	Default Impactor currency ID

Levelable System

Setting	Type	Default	Description
levelable_mode	String	multi_active	How levelables behave (see below)
levelable_max_count	Integer	-1	Max active levelables (-1 = unlimited)
levelable_switch_cooldown_seconds	Integer	0	Cooldown between switching active levelables
levelable_respec_cost	Double	0.0	Currency cost to reset a levelable
levelable_respec_confirmation_required	Boolean	true	Require confirmation before respec
levelable_respec_currency	String	impactor:dollars	Currency used for respec

Levelable Modes:

Mode	Description
single_active	Only one levelable can be active at a time
multi_active	Multiple levelables active, limited by levelable_max_count
all_active	All levelables always active

Party System

Setting	Type	Default	Description
party_enabled	Boolean	true	Enable the party system
party_max_size	Integer	10	Maximum players per party
party_task_sync_enabled	Boolean	true	Share task progress between party members

Global Tasks

Setting	Type	Default	Description
global_tasks_enabled	Boolean	true	Enable the global task system
global_tasks_central_server	String	""	Name of the authoritative server
is_global_tasks_central_server	Boolean	false	Whether this server is the central server

For multi-server setups, designate one server as central. See Ceremony Integration for details.

---

Text Formatting

All text fields support MiniMessage formatting:

{
  "name": "<gold><bold>Epic Quest",
  "description": [
    "<yellow>Complete this <blue>challenging</blue> quest",
    "<gray>Rewards: <green>500 PokeDollars"
  ]
}

Common tags: <red>, <green>, <blue>, <yellow>, <gold>, <gray>, <bold>, <italic>, <gradient:red:blue>.

---

Hot Reloading

Reload configurations without restarting the server:

/journey reload

This reloads tasks, zones, levelables, timelines, buffs, markers, interactables, paths, bounty boards, and messages.

---

Next Steps

1. Create your first task — build a real quest
2. Set up zones — define areas in your world
3. Explore MoLang scripting — add dynamic logic to everything