EcotaleJobs - Jobs System for Hytale

A jobs and rewards plugin for the Ecotale economy stack. Players earn currency from mining ores, killing mobs, chopping trees, harvesting crops, and crafting items.

Screenshots

Mining Rewards

Mining Rewards

Mob Kill Rewards

Mob Kill Rewards

Features

Job Selector (New in 1.1.0)

An optional in-game GUI that lets players choose their active jobs. Open it with /jobs.

Multi-slot system - By default, players can have 1 active job. VIP players can unlock additional slots via permissions
Smart swap - When all slots are full, the oldest active job is automatically replaced
Persistent - Selections are saved across reconnects
9 languages - English, Spanish, Portuguese (BR), French, German, Russian, Japanese, Chinese (Simplified), Turkish

Mining Rewards

Per-ore rewards - Each ore type (Copper, Iron, Gold, etc.) has its own configurable reward range
Auto-classification - Uses Hytale Family tags to detect ore types
Vein Streak System - Audio feedback and bonus coins for consecutive ore mining
Tool Required - Must use a pickaxe (bare hands give no reward)
Tool Quality Bonus - Higher quality tools give up to +25% more coins
Depth Bonus - Deeper mining pays up to +20% more

Mob Kill Rewards

Automatic NPC classification - No manual config required for any mob
180+ mob patterns - Wildcard-based classification covers all NPCs
Third-party mod support - Works with ANY mod that adds custom NPCs
Threat Score algorithm - Calculates tier from HP, damage, and aggression
Physical coin drops - When EcotaleCoins is installed
Anti-Farm system - Diminishing returns to prevent abuse

Woodcutting Rewards (New in 1.1.0)

Full-tree detection - BFS flood-fill detects and rewards the entire tree per fell, not per block
16+ tree species - Softwood, hardwood, and exotic categories with different reward ranges
Complexity bonus - Branchy trees with complex shapes pay up to +50% more
Tool required - Must use an axe
Spatial cooldown - Per-player cooldown prevents double rewards on the same tree

Farming Rewards (New in 1.1.0)

Crop harvest detection - Rewards on mature crop pickup.
16+ crop types - From common crops (Wheat, Carrot) to specialty crops (Pumpkin, Cotton, Grape)
Per-crop config - Each crop type has its own reward range
Non-Eternal and Eternal Support

Crafting Rewards (Experimental)

Disabled by default - Can be enabled in config for testing

Reward Notifications (New in 1.1.0)

HUD toasts - When EcotaleCoins is not installed, players see on-screen reward notifications
Smart batching - Multiple rewards within a short window are grouped into a single message

VIP Multipliers

Coin multiplier - VIPs get 1.2x-2.0x more money
Chance bonus - VIPs get +5-15% higher drop probability
Permission-based

Security & Economy Protection

Anti-Farm - Exponential decay for repetitive farming with variety penalties
Rate Limiting - Per-player burst protection (configurable per job type)
Economy Cap - Server-wide hourly injection limit
Income Smoother - 30-minute rolling window prevents income spikes
Exclusion Lists - Block specific mobs/blocks from rewards
Protected blocks - Respects spawn protection and territory claims

Recommended: EcotaleCoins

EcotaleCoins

For enhanced immersion, consider installing EcotaleCoins alongside EcotaleJobs.

What it adds:

Physical loot drops - Coins spawn as collectible items when mobs die
Tangible rewards - Players physically pick up their earnings from the ground
Risk/reward factor - Coins can be lost on death, adding strategic depth
Bank system - Secure storage with deposit/withdraw via /bank command
Player trading - Drop coins to trade with other players in-world

Integration:

EcotaleJobs automatically detects EcotaleCoins and switches from direct deposits to physical coin drops. No configuration needed.

Installation

Install Ecotale first
(Optional) Install EcotaleCoins for physical coins
Download EcotaleJobs-1.1.0.jar
Place in your Hytale mods/ folder
Restart server

Commands

Command	Description	Permission
`/jobs`	Open the job selector GUI	ecotale.ecotalejobs.command.jobs
`/jobstoggle`	Enable/disable the job selector system	ecotale.ecotalejobs.command.jobstoggle
`/jobsreload`	Hot-reload all EcotaleJobs configs	ecotale.ecotalejobs.command.jobsreload

Permissions

VIP Multipliers

VIP multipliers are permission-based and work with LuckPerms or other permission plugins.

Permission	Coin Multiplier	Chance Bonus	Example Use
`ecotalejobs.multiplier.vip`	Configurable (default 1.2x)	Configurable (default +5%)	Basic VIP rank
`ecotalejobs.multiplier.mvp`	Configurable (default 1.5x)	Configurable (default +10%)	Premium VIP rank
`ecotalejobs.multiplier.mvp_plus`	Configurable (default 2.0x)	Configurable (default +15%)	Elite VIP rank

Job Selector Slots-

Permission	Effect
`ecotalejobs.selector.limit.1`	1 job slot
`ecotalejobs.selector.limit.2`	2 job slots
`ecotalejobs.selector.limit.3`	3 job slots
`ecotalejobs.selector.limit.4`	4 job slots
`ecotalejobs.selector.limit.x`	x job slots

Reward Tables

Mining Rewards (per ore)

Ore	Reward Range	Drop Chance
Copper	1-2	80%
Iron	2-4	100%
Thorium	3-6	100%
Gold	4-8	100%
Silver	4-8	100%
Cobalt	10-20	100%
Adamantite	15-30	100%
Mithril	25-50	100%
Onyxium	25-50	100%

Plus configurable tool quality bonus (+2% per level, max +25%) and depth bonus (up to +20%).

Mob Kill Tiers (wildcard-based classification)

Tier	Reward Range	Examples
WORLDBOSS	10,000-20,000	Dragon_Fire, Dragon_Frost, Titans
BOSS	1,000-3,000	(Reserved for dungeon bosses)
MINIBOSS	200-400	Rex_Cave, Werewolf, Shadow_Knight
ELITE	20-50	Ghoul, Crocodile, Yeti
HOSTILE	4-10	Zombie, Skeleton_Soldier, Trork
PASSIVE	1-2	Skeleton, Sheep, Feran
CRITTER	0-1	Bunny, Chicken, Rat

Woodcutting Rewards (per species)

Category	Species Examples	Reward Range
Softwood	Oak, Birch, Spruce, Pine	1-5
Hardwood	Ash, Willow	3-6
Exotic	Acacia, Mahogany, Ebony, Palm	3-10

Plus complexity bonus (up to +50% for branchy trees).

Farming Rewards (per crop)

Category	Crop Examples	Reward Range
Common	Wheat, Carrot, Potato, Beet	1-4
Medium	Tomato, Corn, Pepper, Rice	2-5
Specialty	Cotton, Flax, Pumpkin, Grape	2-10

Mod Compatibility

EcotaleJobs is designed to work with any Hytale mod that adds custom NPCs.

How it works:

When an unknown NPC is killed, the plugin reads its stats via Hytale's API
A Threat Score is calculated: HP + (DMG × 4) × aggression_modifier
The score is mapped to a tier automatically:

Threat Score	Tier
0-50	CRITTER
50-100	PASSIVE
100-300	HOSTILE
300-700	ELITE
700-1200	MINIBOSS
1200+	BOSS

Override behavior:

Pre-mapped NPCs (wildcard patterns) use their assigned tier
Unknown NPCs use the Threat Score algorithm
Exclusion list can block specific NPCs from rewards

Localization

EcotaleJobs supports 9 languages.

Language	Code
English	en-US
Spanish	es-ES
Portuguese (BR)	pt-BR
French	fr-FR
German	de-DE
Russian	ru-RU
Japanese	ja-JP
Chinese (Simplified)	zh-CN
Turkish	tr-TR

Building from Source

Requirements: Place the Ecotale JAR in the libs/ folder:

Ecotale-1.0.0.jar (from Ecotale project)

The Hytale Server API is resolved automatically from maven.hytale.com.

./gradlew shadowJar

Output: build/libs/EcotaleJobs-1.1.0.jar

License

GPL-3.0 - 2026 MichiWeon