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

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

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

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

Commands

Permissions

VIP Multipliers

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

Job Selector Slots-

Reward Tables

Mining Rewards (per ore)

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

Mob Kill Tiers (wildcard-based classification)

Woodcutting Rewards (per species)

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

Farming Rewards (per crop)

Mod Compatibility

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

How it works:

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

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.

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