Umbraix Jobs Plugin Documentation - v1.2.0
Overview
Umbraix Jobs v1.2.0 is a major update to the plugin that introduces several key features and improvements. This version enhances the job system by adding dynamic mission objectives, a full team management system, a modern and user-friendly GUI, Discord integration, and more. The plugin is designed to provide server owners with the most customizable, feature-rich, and performance-optimized job system available for Minecraft servers (Paper 1.21.1+).

Table of Contents

1. Installation
   
   
2. New Features
   
   • Mission System
     
     
   • Team System
     
     
   • Modern GUI
     
     
   • Discord Integration
     
     
   • Colorful Action Feedback
     
3. Improvements & Enhancements
   
   
4. Compatibility & Integration
   
   
5. Bug Fixes
   
   
6. Configuration Changes
   
   
7. API & Internal Improvements
   
   
8. Miscellaneous
   
   
9. Credits
   

Installation

1. Download the Plugin:
   
   • Obtain the latest Umbraix Jobs v1.2.0 JAR file from the official release.
     
2. Install the Plugin:
   
   • Place the JAR file into the /plugins/ directory of your Paper server.
     
3. Restart the Server:
   
   • Restart your server to load the plugin and generate the default configuration files.
     
4. Configure the Plugin:
   
   • Open /plugins/Umbraix-Jobs/config.yml to start customizing jobs, missions, and teams to fit your server's needs.
     

New Features
Mission System
The Mission System offers a robust framework for dynamic job-related objectives, bringing additional depth and engagement to the game.

• Mission Templates: Easily create job-specific missions (mining, hunting, farming) directly from config.yml.
  
  
• Randomized & Time-Limited Missions: Missions are tailored to each player and can have unique objectives that are randomized and time-sensitive.
  
  
• Real-Time Progress Tracking: Track mission progress live, with colorful feedback messages updating players as they advance.
  
  
• Rewards: Complete missions to earn XP and money—fully configurable rewards can be set for each mission.
  

Team System
The Team System empowers players to collaborate and share XP in a dynamic, interactive way.

• Team Creation & Management: Players can create and manage teams, inviting others and managing team members using /jobs team commands.
  
  
• XP Sharing: Teams share XP based on configurable settings, allowing for more collective play.
  
  
• Persistent Data: Team data is saved across server restarts for continuity.
  
  
• Colorful Team Announcements: Every team action (e.g., join, leave, invite, kick) is communicated with vibrant, color-coded messages.
  

Modern GUI
A modern and intuitive GUI system has been introduced to simplify the management of jobs, missions, and teams.

• Intuitive Item-Based Menus: Easily navigate job stats, missions, and team information through a sleek, item-based interface.
  
  
• Quick Action Buttons: Instant access to job, mission, and team functionalities with one-click buttons.
  
  
• Live Notifications: All job updates, level-ups, rewards, and mission progress are shown instantly in the GUI or action bars.
  
  
• Professional Design: A polished and clean design enhances the overall player experience.
  

Discord Integration
To keep your community engaged, Umbraix Jobs v1.2.0 now supports integration with Discord.

• Webhook Support: Broadcast job-related events, mission completions, and team activities to your server’s Discord channels.
  
  
• DiscordSRV Compatibility: Seamlessly integrate with DiscordSRV for player-linked Discord accounts, enabling easy communication between your Minecraft server and Discord.
  
  
• Configurable Events: Control what events are sent to Discord (e.g., level-ups, missions, team events).
  

Colorful Action Feedback

• Dynamic Action Feedback: Real-time feedback is provided for every job-related action, such as mining, farming, and hunting.
  
  
• Customizable Messages: The color and content of feedback messages are fully configurable via config.yml using Minecraft color codes.
  
  
• Enhanced Immersion: Players will feel more immersed in their job progress with colorful, instant notifications.
  

Improvements & Enhancements

• Simplified Configuration: The configuration structure has been enhanced for easier customization and better expansion in future versions.
  
  
• Expanded Messages: The config.yml now covers a wider range of messages, including those related to missions, teams, and GUI actions.
  
  
• Additional Placeholders: New placeholders, including {job}, {amount}, {xp}, {mission}, {team}, and more, have been added for greater flexibility.
  
  
• Optimized Data Management: Server performance has been improved with smarter data saving mechanisms, reducing lag.
  
  
• Error Handling: Improved error logging and handling make it easier to troubleshoot and debug issues.
  

Compatibility & Integration

• Paper 1.21.1+ Compatibility: Umbraix Jobs is fully compatible with Paper 1.21.1 and later versions.
  
  
• Economy Plugin Support: The plugin supports Vault and popular economy plugins like TheNewEconomy and EssentialsX.
  
  
• Discord Integration: Direct support for DiscordSRV and webhook integration, making it easy to push server events to Discord.
  
  
• Modular Design: The plugin’s modular architecture supports easy expansion, including future features like prestige, leaderboards, and custom jobs.
  

Bug Fixes

• Fixed issues with XP calculations and reward distribution for jobs.
  
  
• Resolved problems with job joining and leaving functionality.
  
  
• Corrected issues with command tab-completion and argument validation.
  
  
• Fixed GUI glitches and improved the responsiveness of in-game menus.
  
  
• Addressed bugs with mission assignment and team XP sharing.
  

Configuration Changes

• Mission Templates: A new mission-templates section has been added to the config.yml file to allow easy customization of job-specific missions.
  
  
• Action Feedback: New action-messages sections for actions like mining, farming, and hunting have been added for greater control over in-game messages.
  
  
• Discord Integration: The discord section has been introduced to configure webhooks and DiscordSRV integration.
  
  
• Expanded Messages Section: The messages section now covers mission, team, and event-related messages.
  
  
• Max Mission and Team Size Settings: New settings to limit the number of missions a player can undertake and the maximum size of a team.
  

API & Internal Improvements

• Refactored core code for better maintainability and performance.
  
  
• Enhanced event handling for missions and teams, ensuring smoother operations and fewer errors.
  
  
• Improved plugin startup and shutdown routines to ensure data integrity.
  
  
• Refined internal integration for Discord webhooks and DiscordSRV.
  

Miscellaneous

• Updated Version: The plugin version has been updated to 1.2.0 in the plugin.yml and pom.xml files.
  
  
• Branding & Credits: Developer information and branding have been added throughout the plugin.
  
  
• Code Cleanup: Legacy code has been cleaned up, and documentation has been improved across the codebase.
  
  
• Logging Enhancements: More detailed logging has been added for server administrators to help with troubleshooting.
  

Credits

• Developer: Prathmesh (prathmesh_pro)
  
  
• Team: Team Umbraix
  
  
• Version: 1.2.0
  
  
• Release Date: May 9, 2025
  

Umbraix Jobs v1.2.0 is now more powerful and feature-rich than ever, providing a professional-level experience for both server owners and players. Whether you’re running a survival, RPG, or adventure server, this plugin is the ultimate tool for managing jobs, missions, and teams efficiently.