Description
AdvancedJobs (Hytale) - Mod Overview
A fully native, GUI-first Hytale jobs system inspired by JobsReborn, built for progression-heavy survival/economy servers.
What This Mod Does
AdvancedJobs adds a complete jobs progression layer where players:
- Join jobs from UI (
/jobsor/job) - Earn XP and money from job-specific actions
- Level up jobs with scaling rewards
- Track progress and earnings in live UI panels
- Use placeholders for HUD/scoreboards/tab lists
- Benefit from optional MMO skill syncing and economy integrations
No player command configuration is required. Core player flow is done in GUI.
Core Features
- Job creation and config-backed reward mappings
- XP gain per action (break, place, kill, craft)
- Leveling system with exponential XP curve
- Income payouts with multipliers and level scaling
- Per-player active job limits (permission-aware)
- Permission-based job access
- GUI admin management tools
- Timed boosts (XP/income)
- Placeholder support with internal fallback behavior
- Notification-based level-up alerts (not chat spam)
- Persistent player progress storage
Default Jobs and Behavior
| Job | Rewards From |
|---|---|
| Miner | Breaking with pickaxe only; no dirt/soil rewards; ore targets configured with higher payouts |
| Builder | Place-only and only for: Furniture_*, Cloth_*, Soil_Clay_*, Rock_*, Wood_* |
| Hunter | Killing entities/players (configured kill mappings) |
| Crafter | Strict explicit craft allowlist (not wildcard-all crafting) |
| Alchemist | Alchemy outputs crafted at alchemy bench, with exclusive routing for configured potion/bomb outputs |
| Farmer | Plant placement targets + configured farming craft targets; no break rewards |
| Chef | Crafting Food_* only |
Commands
/jobs
Opens the Jobs UI.
Requires: advancedjobs.use
/job
Alias of /jobs.
Requires: advancedjobs.use
/jobsadmin reload
Reloads jobs_config.json from disk at runtime.
Requires: advancedjobs.admin
Permissions
advancedjobs.use
Allows using /jobs and /job.
advancedjobs.admin
Full admin access (admin UI/actions, /jobsadmin reload, effectively unlimited max jobs).
advancedjobs.job.<jobid>
Per-job access (examples: advancedjobs.job.miner, advancedjobs.job.chef).
advancedjobs.maxjobs.1 / .2 / .3 / .4
Sets max active jobs by permission tier.
advancedjobs.boost.vip (default sample)
Applies configured permission multipliers (XP/income).
GUI Overview
- Jobs Tab: Browse jobs, view status, join/leave, open job info
- Active Tab: Shows all currently active jobs and live progression
- Progress Tab: Job guide + current levels/xp/income tracking
- Admin Tab: Create/delete jobs, edit reward mappings, apply boosts, adjust defaults
Placeholder Support
Identifier: jobs
Supported placeholders:
%jobs_current_job%%jobs_level_<job>%%jobs_xp_<job>%%jobs_income_<job>%
Behavior:
- Registers as PlaceholderAPI internal expansion when PlaceholderAPI is present
- If PlaceholderAPI is missing, text remains safe/fallback (no hard crash)
Economy Integration
Provider order:
- EcoTale (preferred, if available) – https://www.curseforge.com/hytale/mods/ecotale
- VaultUnlock (fallback if EcoTale is unavailable) – https://www.curseforge.com/hytale/mods/vaultunlocked
All job payouts deposit through the active provider.
MMOSkillTree Integration
Optional MMO sync features include:
- Awarding MMOSkillTree XP when job XP is earned
- Optional income scaling by MMO skill level
- Optional job level to MMO skill synchronization
- Configurable job-to-skill mapping (default mappings included)
Integration:
MMO Skill Tree – https://www.curseforge.com/hytale/mods/mmo-skill-tree
Notifications
Level-up messages are delivered with NotificationUtil using icon:
HayHay_Klop_Head2_Plushie
This replaces chat-style level-up spam.
Data and Config Files
jobs_config.json
Jobs, reward mappings, limits, multipliers, boosts, integration settingsplayers.json
Per-player active jobs, XP/level progress, earnings totals
Installation Notes
- Place mod in your server mods folder
- Optional integrations auto-detect at runtime
- PlaceholderAPI and VaultUnlock are declared optional in manifest
- VaultUnlock support is reflection-based fallback from economy bridge
Optional Dependencies
- VaultUnlock – https://www.curseforge.com/hytale/mods/vaultunlocked
- MMO Skill Tree – https://www.curseforge.com/hytale/mods/mmo-skill-tree
- PlaceholderAPI – https://www.curseforge.com/hytale/mods/placeholder-api
- EcoTale – https://www.curseforge.com/hytale/mods/ecotale
