Перейти к содержимому
Mineforgian

NotQuests

Best Paper-native Quest Plugin ✅ Better than "Quests" ⭐ Tasks ⭐ Multi-Path Objectives & Sub-Objectives ⭐ RPGs ⭐ Multi-Path Conversations ⭐ Reputation Systems ⭐ Tags ⭐ Conditions ⭐ Profiles ⭐ GUI ⭐ Proxy Support ⭐ MiniMessage & Adventure ⭐ & much more!

Загрузки
18K
Подписчики
169
Обновлён
15 июня 2026 г.
Лицензия
GPL-3.0-only

Опубликован 16 августа 2022 г.

NotQuests - Best Quest Plugin

NotQuests allows you to create powerful quests for pretty much any type of server.

  • If you like NotQuests and want more updates, please give it a follow on modrinth to support me! It's just one click :)
  • The latest version of NotQuests will be available exclusively on Modrinth, a platform I'm happy to support!
  • NotQuests has reached more than 60.000 downloads across all resource sites! Thank you!

Please note: updates, bug fixes and support are not guaranteed.

Front image

Attention: Please use Paper or a fork of Paper, like Purpur or Pufferfish. Spigot/Bukkit is not supported.

=> Getting started guide <=

Requirements to run NotQuests

  • Minecraft 26.1.2 with Paper 26.1.2 (only the latest Minecraft version is actively developed. Older Minecraft versions only work with older NotQuests versions)
  • Java 25

Helpful links

Integrations / optional plugins:

  • MySQL Database - strongly recommended. Otherwise, SQLite will be used.
  • Citizens - needed for Citizens NPC stuff to work. You can also use Armor Stands without Citizens, or FancyNPCs
  • FancyNPCs - an alternative to Citizens
  • Vault - for Economy stuff
  • PlaceholderAPI - needed for placeholders
  • MythicMobs - you can use MythicMobs in KillMobs objectives
  • EliteMobs - to use the KillEliteMobs objective
  • Slimefun - to use the SlimefunResearch objective
  • LuckPerms - to use the Permission Reward
  • Towny - to use various Requirements and Objectives
  • Jobs Reborn
  • EcoMobs
  • Infinite other plugins through placeholder and command objectives/conditions/actions.

NotQuests is an incredibly easy-to-use, powerful and open-source minecraft Quests plugin for Paper which allows you to create detailed quests.

A powerful and flexible quest plugin does not have to be a pain to use. NotQuests goal is to take the simplicity of "easy" Quest plugins and the power & flexibility of more advanced plugins - and combine it! It allows you to create powerful quests in a logical and simple way.

Some quest plugins want to be super powerful and flexible - but they are too hard to use. Some want to be easy-to-use, but they aren't powerful and only suitable for simple pump-and-dump quests.

NotQuests strives to be easy-to-use & intuitive while being super flexible & powerful at the same time! You can create both simple pump-and-dump farming quests, as well as complex omni-path storylines.

The command system is much faster, easier & flexible than what other Quest plugins have to offer, and I did not notice any performance issues either. Do note that one goal of NotQuests is to be modern. Until an abstract version is finished, do not expect for old Minecraft versions to be supported for ages. NotQuests is evolving quick!

Features

  • Proxy support (like Velocity, Waterfall & BungeeCord)
  • Custom YAML-based GUIs: The entire GUI system is configurable via YAML files, supporting tabbed interfaces, paged item lists, action buttons, custom skull textures, and dynamic placeholders.
  • Quest Profiles: Every player with the permission node "notquests.user.profiles" can create profiles in notquests! Each profile has their own quest points, tags active & completed quests etc. This would allow players to start over if they want to, in order to choose a different path, do a speedrun or just to experience your RPG again - or whatever else!
  • Sub-objectives! Each objective can have unlimited sub-objectives. And each sub-objective can also have unlimited sub-sub-objectives.. and so on!
  • Variable system for registering flexible Actions & Conditions at the same time
  • Actions, Conditions, Objectives & Conditions are registered dynamically. This makes it easy to add your own via the API or by contributing.
  • Tag System (save data per-player)
  • Flexible Conversation system, tightly integrated with actions & conditions
  • Multiple integrations with other plugins (if not, you can achieve a lot with Placeholder Conditions/Objectives & Console Command Actions)
  • Great, extensive API
  • Complete GUI for the User Interface
  • Beautiful GUI & Chat Design
  • Modern coloring using MiniMessage (legacy is unsupported)
  • Player data is saved in MySQL or SQLite, Quest configuration data in a configuration file
  • Quest Point System (You can create your own currency via tags)
  • Smart Command Tab Completions for all User and Admin commands
  • Many usable Objectives, Conditions (= Requirements) and Actions (= Rewards). Full list of objectives: https://www.notquests.com/docs/documentation/types/objectives
  • Flexible NPC system - this would allow you to easily integrate other NPC plugins with notquests in the future

Sub-Objectives

Sub Objectives

PlaceholderAPI Placeholders

Player Placeholders:

%notquests_player_has_completed_quest_QUESTNAME% %notquests_player_has_current_active_quest_QUESTNAME% %notquests_player_is_objective_unlocked_and_active_OBJECTIVEID_from_active_quest_QUESTNAME% %notquests_player_is_objective_unlocked_OBJECTIVEID_from_active_quest_QUESTNAME% %notquests_player_is_objective_completed_OBJECTIVEID_from_active_quest_QUESTNAME% %notquests_player_questpoints% %notquests_player_active_quests_list_horizontal% %notquests_player_active_quests_list_vertical% %notquests_player_completed_quests_amount% %notquests_player_active_quests_amount% %notquests_player_tag_TAGNAME% %notquests_player_variable_VARIABLENAME% %notquests_player_expression_EXPRESSION% %notquests_player_rounded_expression_EXPRESSION% %notquests_player_quest_cooldown_left_formatted_QUESTNAME%

Ченджлог

6.3.0Релиз26.1.2 · 15 июня 2026 г.

This release adds several new objective/action/variable types, restores BetonQuest support for modern BetonQuest servers, improves command suggestions, and makes the documentation much more useful for building quests.

New objectives

  • New Harvest objective. Counts only fully grown crops, grown cactus/sugar-cane segments, and melon/pumpkin fruit. Directly placed fruit/cactus/sugar-cane blocks are ignored to reduce place-break abuse.
  • New BrewItems objective. Counts freshly brewed items when players take them from a brewing stand, so manually inserted old potions do not give progress.
  • New TradeWithVillager objective. Counts matching result items taken from villager trade windows, so you can build trading/economy quests around what the player actually receives.
  • New TameMobs objective. Counts mobs tamed by the player, with support for a specific entity type or any.
  • New SmithItems objective. Counts matching result items taken from a smithing table, useful for upgrade and armor-trim quest steps.
  • New Die objective. Counts player deaths, optionally filtered by a Minecraft damage type such as fall, lava, drown, or player_attack.
  • New ShootArrow objective. Counts arrows shot by the player that land inside a configured radius around a target location, or inside a WorldEdit selection when WorldEdit is installed.
  • Objective location markers are documented. Objectives can now be documented and managed with location set, location enable, and the clean location disable command for Wynncraft-style guiding markers.

BetonQuest 3

  • BetonQuest support is back for BetonQuest 3.0.0 and newer. NotQuests restores the bridge features from older releases: NotQuests actions/conditions inside BetonQuest, BetonQuest actions from NotQuests, a BetonQuest objective-state objective, a BetonQuestCondition variable, and the notquests BetonQuest conversation interceptor.
  • Older BetonQuest versions stay disabled. BetonQuest 1.x/2.x are detected and skipped

Command and usability improvements

  • Duration arguments accept milliseconds. Values such as 500ms, 1s, 5m, 2h, and 1d are accepted; bare numbers are still treated as milliseconds.
  • Better value suggestions. Boolean arguments suggest true/false, number and coordinate arguments suggest useful examples, value flags suggest values after the flag, and item selections keep suggestions for following arguments.
  • New player/world variables. FoodLevel, Saturation, DistanceToLocation, NearbyEntityCount, and Weather are available for conditions, expressions, and settable actions where applicable.
  • New visual/player actions. ShowTitle, ShowActionBar, SpawnParticle, and Teleport make it easier to build guided quest moments without command-workarounds.
  • Cleaner command behavior. Comma-separated item selections work unquoted, item amount/world/NPC/command suggestions are restored after positional amounts, short alias clutter is removed from suggestions, and the command-hint action bar shows more useful argument labels.
  • More flexible location-region setup. ReachLocation no longer requires WorldEdit; it can be created with world x y z radius, while WorldEdit users still get the worldeditselection shortcut.
  • Easier Interact objective setup. In-game admins can now use Interact <amount> looking to target the block they are looking at instead of typing world coordinates by hand. Interact objectives with no explicit --leftClick or --rightClick flag now count either block click instead of becoming impossible to complete.
  • Easier and more reliable objective location markers. Wynncraft-style guiding markers now support location set here, location set looking, location status, location preview, and location clear, can optionally show a bossbar compass with visual.objective-tracking.location-compass.enabled, hide the fake beam source below solid targets instead of visually replacing or floating above them, keep the fake beam alive while the player stands still, clean themselves up more safely, and refresh correctly after chunk loads.

Compatibility

  • Built for Paper 26.1.2.
  • Requires Java 25 for the 26.1.2 build.
6.2.0Релиз26.1.2 · 14 июня 2026 г.

This release rebuilds the entire command system on Paper's native command API and removes the third-party Cloud framework completely which doesn't seem to be actively maintained anymore. This should allow notquests to be updated to newer minecraft versions quicker.

✨ New features

  • New FeedMobs objective. Counts how many times a player feeds a particular mob - wheat to a cow, seeds to a chicken, and so on
  • Helpful command menus are back. Typing an incomplete admin command - /qa actions, /qa edit <quest> objectives, /qa conditions, … - now lists the available sub-commands instead of Minecraft's blunt "Unknown or incomplete command" error.

⌨️ A rebuilt command system

  • No more Cloud. The command framework has been migrated entirely off the third-party Cloud library onto Paper's native Brigadier command API, behind a small in-house wrapper. They're the same commands you already know, just one fewer dependency that can break on an update.
  • A more useful hint bar. The "what to type next" helper above your hotbar now shows the actual argument it wants - [TagName], [Block], [amount] - instead of a generic, sometimes-wrong label, and no longer renders a double /.
  • Cleaner tab-completion. Suggestion lists are no longer cluttered by single-letter sub-command aliases or by an unselectable <Enter String> entry when real values (blocks, tags, …) are available.
  • Flag values complete correctly. After typing flags that need a value - for example --delay or --player — tab-completion now suggests the value for that flag instead of suggesting --delay / --player again.

🐛 Bug Fixes

  • GiveItem rewards and item objectives parse correctly. … rewards add GiveItem grass_block 1 no longer fails with "Cannot parse item argument" - the item argument no longer swallows the amount that follows it. Comma-separated material lists work again too, unquoted: … GiveItem grass_block,dirt 1.
  • Your tags are suggested again. Adding a tag-based action or condition (TagInteger, TagString, …) now tab-completes your existing tags instead of only offering <Enter String>.
  • Boolean values are suggested where you expect them. Commands like /qa conditions check Flying equals <value> now suggest true and false for the final value.
  • Conversation NPC lists are readable. /qa conversations list now shows attached NPCs as labels like citizens:5 (Guard Captain) instead of dumping a raw Java-style object string.
  • Number variables that take more than one value work. RandomNumberBetweenRange <min> <max>, block coordinates, and similar no longer have the first number eat the rest of the line.
  • Checking a Block variable no longer errors. /qa variables check Block <world> <x> <y> <z> returned a NullPointerException because the y and z coordinates were mis-registered; it now returns the block at that position.
  • Commands with two value-flags behave. When a flag's value is omitted (e.g. --min --max 3), the parser no longer mistakes the next flag for the missing value and silently drops it.
  • Category display names can contain spaces again — /qa categories edit <category> displayName set Some Long Name - matching how quest display names already worked.

🛡️ Reliability

  • Bad version-specific config values no longer crash loading. If a config contains a particle or item name that does not exist on this server version, NotQuests now logs a concise warning and falls back to a safe default instead of failing with a raw enum/config error. This covers general particle settings, GUI item materials, quest/category item stacks, and saved item-selection data.
  • The bundled demo conversation no longer uses delays. The sample conversation now avoids delay settings

🛠️ Under the hood

  • A real end-to-end command test now runs in CI. Every push boots an actual Paper server with the freshly built plugin and runs every registered objective, action, condition, trigger and tag type through the console, failing the build on error. This caught several of the fixes in this release.

✅ Compatibility

Built for Paper 26.1.2 and Java 25.

6.2.0Релиз1.21.11 · 14 июня 2026 г.

This is a backport of NotQuests 6.2.0 for servers running Paper 1.21.11.

It includes the same 6.2.0 command-engine migration, command help/suggestion fixes, FeedMobs objective, runtime command sweep coverage, and reliability fixes from the main 6.2.0 release.

This build also handles invalid version-specific config values more gracefully: bad particles, GUI item materials, quest/category item stacks, and saved item selections now log a concise warning and fall back to a safe default for this server version instead of crashing load.

Required software

  • Paper 1.21.11
  • Java 21 or Java 25
  • Optional NPC integrations are compiled against Citizens 2.0.41 and FancyNPCs 2.10.1.
6.2.0Релиз1.21.1 · 14 июня 2026 г.

This is a backport of NotQuests 6.2.0 for servers running Paper 1.21.1.

It includes the same 6.2.0 command-engine migration, command help/suggestion fixes, FeedMobs objective, runtime command sweep coverage, and reliability fixes from the main 6.2.0 release.

This build also handles invalid version-specific config values more gracefully: bad particles, GUI item materials, quest/category item stacks, and saved item selections now log a concise warning and fall back to a safe default for this server version instead of crashing load.

Required software

  • Paper 1.21.1
  • Java 21 or Java 25
  • Optional NPC integrations are compiled against Citizens 2.0.35 and FancyNPCs 2.9.2.
6.1.1Релиз26.1.2 · 7 июня 2026 г.

The command experience got a serious glow-up, NPC quest givers behave the way you'd expect, and a whole stack of bugs are gone.

✨ The good stuff

⌨️ The command-hint bar has been polished:

  • It tells you what comes next again - [Quest Name], [amount], or <option> for sub-commands - instead of a useless [...].
  • It sticks around when you pause instead of flickering away, and echoes what you're typing as you go.
  • Number arguments are colorful again. ✨

🔖 New: /qa tags check <tag> [--player] - peek at a tag's current value (reputation, flags, whatever) without having to remember its type. Perfect for debugging your tag setups.

✦ FancyNPCs quest givers now sparkle. FancyNPCs with a quest attached finally show the floating quest-giver particle above their head, just like Citizens NPCs and armor stands do.

🤝 Smoother NPC setup. Attaching quests and conversations to NPCs now works exactly as documented - type citizens:0 / fancynpcs:<id> and it attaches to that NPC, or use rightClickSelect (now suggested in tab-completion, for both quests and conversations) to just click the NPC in-game.

🐛 Fixes

  • "You don't meet the requirements" actually shows up now when you try to accept a quest you can't take - from an NPC, an armor stand, or the menu. Before, the menu just silently closed
  • No more "Confirm Command Execution" popup when clicking conversation options or the chat [CHOOSE] / [ACCEPT] buttons.
  • Action rewards work again - /qa edit <quest> rewards add Action … no longer errors out.
  • /qa edit <quest> npcs list is readable - it shows citizens:0 / fancynpcs:<id> instead of a wall of internal gibberish.
  • The Citizens quest-giver particle disappears when you clear the quest from an NPC (it used to linger forever).
  • /qa progress formatting has been fixed

🔌 Integrations

  • FancyNPCs updated from 2.10.0 to 2.10.1.

🛠️ Under the hood

  • The command system now runs on Paper's native Brigadier - we no longer use LegacyPaperCommandManager
6.1.0Релиз26.1.2 · 5 июня 2026 г.

This release adds FancyNPCs support and a cow-milking objective, makes saving quest data a lot safer, brings every plugin integration up to its latest version, and fixes a long list of gameplay bugs.

✨ New features

  • FancyNPCs support: FancyNPCs is now supported, alongside Citizens and armor stands.
  • New MilkCow objective. Counts cows milked (detected by right-clicking a cow with an empty bucket), mirroring the Shear Sheep objective with an optional cancel flag.

🛡️ Reliability & data safety

  • No more lost quest progress on a failed save. Player data is now saved inside a single database transaction, so a mid-save failure (full disk, lock timeout, dropped connection) rolls back cleanly instead of deleting data it cannot re-write.
  • Thread-safety fixes around the online-player registry, a player's completed/failed/pending quest lists, quest tags (setting a tag to nothing now removes it), and conversation chat history - preventing rare crashes and data corruption.
  • Visual effects on the main thread. Armor-stand quest-giver particles and the quest/objective completion title + sound now always run on the main thread, where Paper requires them.

🐛 Bug Fixes

  • Non-OP players can use /notquests again. Its notquests.use permission (default on) was never registered on Paper, so non-operators got "Unknown command". The admin commands (/nqa, /qa) still require operator / notquests.admin.
  • Tab-completing a mob/entity argument (for KillMobs, SpawnMob, …) no longer throws an error and shows suggestions again.
  • Killing an EcoMob now counts towards a matching KillMobs objective (the kill was never detected before).
  • "Reach job level" objectives now track your real Jobs level, including admin changes like /jobs level add, and complete once you reach the target level.
  • Attaching a quest to an armor stand works again - the "add" item did nothing before. Right-click the armor stand with it.
  • Quest previews from armor stand / FancyNPCs quest givers no longer error out, and the NPC quest-list GUI shows its proper title instead of "Language string not found".

🔌 Integration updates

Every supported plugin integration is now on its latest version (old → new):

  • Citizens 2.0.30 → 2.0.42 (escort-NPC following moved to the new Citizens API)
  • PlaceholderAPI 2.11.5 → 2.12.2
  • MythicMobs 5.3.0 → 5.12.1
  • EliteMobs 9.1.9 → 10.4.0
  • WorldEdit 7.3.0 → 7.4.3
  • LuckPerms 5.4 → 5.5
  • Towny 0.98.4.4 → 0.103.0.0
  • Jobs Reborn 4.17.2 → 5.2.6.5
  • Floodgate 2.2.2 → 2.2.5
  • eco 6.38.3 → 7.6.3
  • EcoBosses 8.78.0 → EcoMobs 11.7.0 (the developer renamed EcoBosses to EcoMobs; existing eco-mob spawn actions keep working)
  • Vault (1.7.1) and Slimefun (RC-37) were already current.

Nothing changes in how you use these - the plugin installed on your server is still what runs.

🧩 Dependency upgrades

  • Adventure 4.18.0 → 4.26.1 (kept on the 4.x line to match Paper 26)
  • commons-io 2.11.0 → 2.22.0
  • PacketEvents 2.12.0 → 2.12.2
  • geantyref 1.3.13 → 1.3.16
  • Configurate 4.1.2 → 4.2.0
  • Lombok 1.18.44 → 1.18.46
  • SQLite 3.53.1.0 → 3.53.2.0
  • Paper dev bundle build 64 → 69
  • Shadow 9.4.1 → 9.4.2
  • Gradle 9.0.0 → 9.5.1

🗑️ Removed

  • UltimateJobs - no longer maintained; its integration and "reach job level" objective were removed. Jobs Reborn still covers job objectives.
  • Leftover ZNPCs and BetonQuest references that were no longer used.

🛠️ Under the hood

  • More reliable builds. Every plugin integration is bundled with the project as a local file instead of being downloaded from a third-party repository at build time, so a relocated/offline repo can no longer break a build.

✅ Compatibility

Built for Paper 26.1.2 and Java 25.

6.0.1Релиз26.1.2 · 18 мая 2026 г.

This release brings NotQuests up to the latest Paper version, refreshes all translations, and fixes a handful of annoying command bugs.

🧩 Dependency upgrades

  • Updated to Minecraft / Paper 26.1.2.
  • Newer InvUI 2.1.0 (the GUI library) and HikariCP 7.0.2 (database pooling).

🐛 Bug Fixes

  • Tab-completing a boolean condition (like Climbing, Flying, or ActiveQuests) under /qa conditions add no longer crashes.
  • /qa conditions add no longer rejects valid input with "Invalid syntax", so you can actually create those conditions now.
  • /nq abort works again instead of throwing an error, including when you have no active quests.
  • /nq abort, /nq progress, /qa failQuest, and /qa completeQuest no longer get blocked by a bogus "accepting/previewing is disabled" message when the quest preview GUI is turned on.

🌍 Translations

  • All 31 languages are back in sync with English. Outdated and renamed entries were cleaned up, and missing lines were filled in, while existing translations were left untouched.

🛠️ Refactors

  • Reworked, nicer demo conversation. (/qa conversations create namehere --demo)
6.0.0Релиз1.21.11 · 18 мая 2026 г.

This is a backport for paper 1.21.11

Breaking Changes

  • Paper 1.21.1 is now supported
  • Java 21 is now required (previously Java 17)
  • Removed integrations: BetonQuest, zNPCs, and ProjectKorra have been temporarily removed to keep notquests simple and easier to maintain. If you relied on BetonQuest conditions/events, zNPCs NPC linking, or ProjectKorra objectives, these are no longer available.

New Features

Custom YAML-based GUIs

  • The entire GUI system has been rewritten with a new YAML-driven GUI framework
  • GUIs are now fully configurable via YAML files in the plugins/NotQuests/guis/ folder
  • Supports tabbed interfaces, paged item lists, and action buttons
  • Default GUIs included: main menu with tabs (active quests / take quests), quest preview, NPC quest selection, category browsing, and quest abort confirmation
  • Custom skull textures, dynamic placeholders (%QUESTNAME%, %CATEGORYNAME%, %PLAYER%, etc.), and per-item lore/display name from the language file
  • Powered by InvUI

Комментарии

Загружаем…