📜 Contracts | Dynamic PvP, PvE & Mining System

[invoulting]

Take your server to the next level with a fully automated contract system that keeps players engaged with constant objectives, rewards, and progression.


Whether you're running Survival, RPG, or Economy, this plugin adds endless replay ability without requiring heavy configuration.

Overview​

Contracts is a dynamic system that automatically generates tasks for players to complete, rewarding them for gameplay actions like killing mobs, players, or mining resources.


No setup needed. Just install and play.

GitHub​

Access the source code, report issues, or contribute:


View Source Code on GitHub


(Direct repo: https://github.com/involuting/Contracts/tree/master)

Features​

✔ Fully automatic contract generation
✔ No configuration required (plug & play)
✔ Supports PvP, PvE, and mining contracts
✔ Built-in contract expiration system
✔ Real-time progress tracking
✔ Reward system with Vault support
✔ Clean GUI with pagination
✔ Persistent data storage
✔ High-performance and optimized

Contract Types​

Player Contracts​

• Kill specific players
• Scalable difficulty based on requirements

Mob Contracts​

• Kill mobs such as:
  • Zombie
  • Skeleton
  • Creeper
  • Spider
  • Enderman

Mining Contracts​

• Mine blocks such as:
  • Stone
  • Iron Ore
  • Diamond Ore
  • Coal Ore

Rewards System​

Players are rewarded automatically upon completion:

• Economy rewards (Vault supported and more to be supported)
• Scaled rewards based on difficulty
• Instant payout on completion

Advanced GUI System​

• Null-safe rendering (no crashes)
• Fallback slots for invalid data
• Stable refresh cycles
• Clean and responsive layout
• Smooth pagination system

⚙How It Works​

1. Contracts are generated automatically at intervals
2. Players open the GUI and accept contracts
3. Progress updates in real-time
4. Complete the task → receive rewards instantly

Installation​

1. Download the .jar
2. Place it in your /plugins folder
3. Restart your server
4. (Optional) Install Vault for economy rewards

Dependencies​

• Spigot / Paper 1.21+
• Vault (optional)

Upcoming Features​

• Contract rarity system (Common → Legendary)
• NPC contract givers
• Player stats & progression
• Leaderboards
• Animated GUI upgrades
• Custom contract API

Developer Info​

Built with a modular architecture:

• Generator → Handles contract spawning
• Factory → Creates contracts
• Manager → Stores & manages contracts
• Listeners → Tracks player actions
• Storage → Data persistence
• GUI Layer → Safe rendering system

License​

Free for personal and learning use.
Not allowed to resell or redistribute as paid content

Support​

If you enjoy the plugin, leave a review and feedback!

Contact me via discord https://discord.gg/YqSYRA2fH