# vJourney<\/p>\n
**Turn your server’s quest system into a native Minecraft experience.**<\/p>\n
vJourney lets you create fully custom quest trees that live inside Minecraft’s own advancement menu \u2014 no external GUIs, no extra commands for players to memorize. Just open advancements and play.<\/p>\n
—<\/p>\n
## \u2726 What is vJourney?<\/p>\n
vJourney is a Paper plugin that uses Minecraft’s built-in advancement screen as a quest board. You define quests in simple YAML files, connect them into branching trees, and players progress through them naturally \u2014 all inside the familiar advancement interface they already know.<\/p>\n
Every quest can have three visual states: **blocked**, **in progress**, and **completed** \u2014 each with its own description, so players always know what to do next.<\/p>\n
—<\/p>\n
## \u2726 Features<\/p>\n
– **Visual quest trees** built on the native advancement menu \u2014 no external GUIs
\n– **Branching paths** with parent\/child hierarchy, multi-parent convergence, and hidden branches that reveal themselves as players progress
\n– **Three frame styles** \u2014 task, goal, and challenge \u2014 to distinguish quest types visually
\n– **Rich trigger system** supporting mob kills, item holding, region entry, BetonQuest tags and points, PlaceholderAPI values, permission nodes, and more
\n– **Progress counters** with live display in the quest tooltip
\n– **Persistent or state-based** completions \u2014 quests can lock in permanently or react to changing conditions
\n– **Announcements** \u2014 local chat, global chat, title, actionbar, and toast notifications, fully configurable per quest
\n– **Custom icons** with support for custom model data (ItemsAdder \/ Nexo compatible)
\n– **Multiple tabs** \u2014 organize quests into independent categories, each with its own icon, background, and display order
\n– **Vanilla advancements** can be hidden so only your quests are shown
\n– **Bilingual** \u2014 ships with `en_US` and `pt_BR` out of the box<\/p>\n
—<\/p>\n
## \u2726 How It Works<\/p>\n
You create a `.yml` file inside `plugins\/vJourney\/categories\/`. Each file is one tab in the advancement menu. Inside it, you define quests and connect them with `parent` links to form a tree.<\/p>\n
“`
\n[Arrive at the Village] \u2500\u2500\u25ba [Villager’s Request] \u2500\u2500\u252c\u2500\u2500\u25ba [The Mine Problem] \u2500\u2500\u2510
\n \u2502 \u251c\u2500\u2500\u25ba [Village Council]
\n \u2514\u2500\u2500\u25ba [Lost Harvest] \u2500\u2500\u2518
\n“`<\/p>\n
Players see the full tree, track their progress in each quest’s tooltip, and unlock new branches as they complete objectives. Hidden branches can reveal secret paths, side quests, and surprise rewards.<\/p>\n
—<\/p>\n
## \u2726 Trigger System<\/p>\n
Quests complete automatically when their trigger condition is met. Built-in triggers include:<\/p>\n
| Trigger | What it detects |
\n|—|—|
\n| `mob_kill` | Kill a specific mob type N times |
\n| `mythicmob_kill` | Kill a MythicMobs mob by internal name |
\n| `item_hold` | Hold a specific item in your main hand |
\n| `region_enter` | Enter a WorldGuard region |
\n| `bqtag` \/ `bqpoint` | BetonQuest tag or point threshold |
\n| `placeholder` | Any PlaceholderAPI placeholder matching a value |
\n| `permission` | Player has a specific permission node |<\/p>\n
Soft dependencies are detected automatically \u2014 triggers only activate for plugins that are actually installed.<\/p>\n
—<\/p>\n
## \u2726 Requirements<\/p>\n
| Dependency | Type |
\n|—|—|
\n| Paper 1.21+ | Required |
\n| UltimateAdvancementAPI 3.0.0-beta-2 | Required |
\n| WorldGuard | Optional |
\n| MythicMobs | Optional |
\n| BetonQuest | Optional |
\n| PlaceholderAPI | Optional |
\n| LuckPerms | Optional |<\/p>\n
—<\/p>\n
## \u2726 Quick Setup<\/p>\n
1. Drop `vJourney.jar` and `UltimateAdvancementAPI.jar` into your `plugins\/` folder
\n2. Start the server \u2014 a working example category is generated automatically
\n3. Copy or edit the example file to create your first quest tree
\n4. Run `\/vjr reload` to apply changes live, no restart needed<\/p>\n
> \ud83d\udcd6 **Full documentation** \u2014 syntax reference, all triggers, positioning guide, and complete examples \u2014 is available on the Wiki.<\/p>\n","protected":false},"excerpt":{"rendered":"
A powerful custom advancement engine designed to guide players, track completed missions, and create immersive quest-trees.<\/p>\n","protected":false},"featured_media":167243,"template":"","meta":{"_minecraft_slug":"vjourney","_minecraft_project_id":"Z8gGL8iq","_minecraft_author":"EullerAkoz","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":12,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vjourney.zip","_minecraft_size_bytes":372012,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:59:20.305246Z","_minecraft_date_created":"2026-05-14T03:30:53.136683Z","_minecraft_date_modified":"2026-05-14T05:10:45.801662Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vjourney","_minecraft_icon_attachment_id":167243,"_minecraft_imported_at":"2026-06-09T18:51:38+00:00","_minecraft_import_hash":"9138e9732d24d0577aa0c91dd5c7083e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,873,126,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-167242","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n