Full Source Code | NexusContracts - Escrow Quest System


NexusContracts — Source Code

Own the full architecture. Extend it, fork it, make it yours.

Complete, commented Java source for NexusContracts — escrow contracts, faction reputation, mission chains, group contracts, a public API, and Folia-native scheduling.

Java 17 • Gradle 8 • Paper 1.20.4 • Folia • fully documented
​


What is this?

NexusContracts is a production-quality economy plugin that puts a bi-directional contract board on your server — faction-issued quests and player-posted escrow contracts on one paginated GUI. This add-on gives you every Java file: managers, database layer, events, GUI system, commands, reward engine, PlaceholderAPI expansion, Discord webhook service, and the public developer API.

Every class ships with Javadoc covering design intent and concurrency model. The architecture is built to be extended — adding objective types, swapping reward backends, or hooking custom factions are all isolated changes.

This is the source add-on. You need it only if you want the code itself — the compiled plugin is sold separately.


What You Get

  • Full Java source: every class in the de.todesstoss.contracts namespace — no obfuscation, no stubs.
  • Gradle build setup: build.gradle.kts with Shadow, HikariCP + bStats relocation, bundled JDBC drivers — builds with ./gradlew build out of the box.
  • Full resource files: plugin.yml, heavily-commented config.yml, messages_en.yml, and all default faction/rank examples.
  • Public API skeleton: NexusContractsAPI + ApiImpl + NullApiImpl — callers never need to null-check the handle.


Architecture Highlights

  • manager/: sixteen managers — ContractManager (lifecycle, escrow, reconciliation), FactionManager, RankManager, ChainManager, BidManager, GroupContractManager, WatchlistManager, DiscordWebhookService (token-bucketed), and more.
  • database/: DatabaseManager with HikariCP pooling, UUID primary keys, full async CRUD, idempotent schema migration, and startup escrow reconciliation across SQLite, H2, MySQL, and MariaDB.
  • event/: six Bukkit events — ContractPostedEvent (cancellable), ContractAcceptedEvent, ContractCompletedEvent, ContractCancelledEvent, ContractExpiredEvent, PlayerRankUpEvent.
  • api/: NexusContractsAPI + ApiImpl + NullApiImpl — callers never need to null-check the handle.
  • reward/: RewardParser + RewardService turning the MONEY:RANGE: / ITEM: / COMMAND: grammar into executed rewards — isolated and easy to extend.
  • util/Schedulers: transparently targets Folia region/async schedulers or falls back to BukkitScheduler — no changes needed when deploying on Folia vs. Paper.


Why Buy the Source?

  • Learn crash-safe escrow: see exactly how money is held, reconciled on startup, and released — a pattern applicable to any economy plugin.
  • Folia reference: Schedulers and region-aware economy calls are a working example for Paper, Purpur, and Folia compatibility in one codebase.
  • Extend or white-label: add objective types, reskin the GUI, rename the package — config-driven architecture means most changes never touch Java.
  • Clean API hook points: six lifecycle events and NexusContractsAPI let you link contracts to your own systems without touching core code.


Requirements

  • JDK 17+ and Gradle 8 (wrapper included).
  • Paper API 1.20.4 or Folia — resolved automatically by the build script.
  • Internet connection on first build.


License & Terms

By purchasing this source code, you agree to:

  • No resale: you may not sell, sublicense, or commercialize the source or any modified version.
  • No redistribution: you may not share or hand out the source, in whole or in part, to any third party.
  • No reupload: you may not republish the source or any derivative on any platform, public or private.

You may freely use and modify the source for your own server(s). Personal-use license only; all rights remain with the author. Not legally reviewed.


Stop guessing how it works — read the source. ✦
Unzip, open in your IDE, and build in minutes.
​
Top