EcotaleJobs - Jobs System

EcotaleJobs - Jobs System for Hytale

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

Screenshots

Mining Rewards

Mob Kill Rewards

Features

Mining Rewards

Tier-based rewards - Ores classified by rarity (COMMON → LEGENDARY)

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 (pending - waiting for Hytale API)

Depth Bonus - Deeper mining pays 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

VIP Multipliers

Coin multiplier - VIPs get 1.2x-2.0x more coins

Chance bonus - VIPs get +5-15% higher drop probability

Permission-based - Works with LuckPerms

Security & Economy Protection

Anti-Farm - Diminishing returns for repetitive farming

Rate Limiting - Per-player burst protection

Economy Cap - Server-wide hourly injection limit

Exclusion Lists - Block specific mobs/blocks from rewards

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

Install Ecotale first

(Optional) Install EcotaleCoins for physical coins

Download EcotaleJobs-1.0.0.jar

Place in your Hytale mods/ folder

Restart server

Configuration

Located in mods/Ecotale_EcotaleJobs/EcotaleJobs.json:

{ "DebugMode": false, "MobKills": { "Enabled": true, "Tiers": { "CRITTER": { "CoinType": "COPPER", "MinCoins": 0, "MaxCoins": 1, "DropChance": 40 }, "PASSIVE": { "CoinType": "COPPER", "MinCoins": 1, "MaxCoins": 2, "DropChance": 100 }, "HOSTILE": { "CoinType": "COPPER", "MinCoins": 4, "MaxCoins": 10, "DropChance": 100 }, "ELITE": { "CoinType": "IRON", "MinCoins": 2, "MaxCoins": 5, "DropChance": 100 }, "MINIBOSS": { "CoinType": "COBALT", "MinCoins": 2, "MaxCoins": 4, "DropChance": 100 }, "BOSS": { "CoinType": "GOLD", "MinCoins": 1, "MaxCoins": 3, "DropChance": 100 } }, "Security": { "MaxRewardsPerMinute": 60, "EnableAntiFarm": true, "AntiFarmThreshold": 15, "AntiFarmDecayPerKill": 0.08 } }, "Mining": { "Enabled": true, "Tiers": { "NONE": { "MinCoins": 0, "MaxCoins": 0, "DropChance": 0 }, "COMMON": { "MinCoins": 1, "MaxCoins": 2, "DropChance": 80 }, "UNCOMMON": { "MinCoins": 2, "MaxCoins": 4, "DropChance": 100 }, "RARE": { "MinCoins": 4, "MaxCoins": 8, "DropChance": 100 }, "EPIC": { "CoinType": "IRON", "MinCoins": 1, "MaxCoins": 2, "DropChance": 100 }, "LEGENDARY": { "CoinType": "IRON", "MinCoins": 2, "MaxCoins": 4, "DropChance": 100 } }, "VeinStreak": { "Enabled": true, "MaxStreak": 6, "TimeoutMs": 3000, "BonusEnabled": true, "AudioEnabled": true } }, "VipMultipliers": { "Enabled": true, "Multipliers": { "vip": 1.2, "mvp": 1.5, "mvp_plus": 2.0 }, "ChanceBonuses": { "vip": 5, "mvp": 10, "mvp_plus": 15 } } } 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

Important: LuckPerms Configuration

EcotaleJobs does NOT automatically give rewards. VIP multipliers only work if you configure them in LuckPerms:

# Grant VIP multiplier to a group /lp group vip permission set ecotalejobs.multiplier.vip true

# Grant MVP multiplier to premium group /lp group mvp permission set ecotalejobs.multiplier.mvp true

# Grant MVP+ to elite group /lp group mvp_plus permission set ecotalejobs.multiplier.mvp_plus true Tier Classification

Mining Tiers (auto-detected via Family tags)

Tier Ores

LEGENDARY Mithril, Adamantite, Thorium, Onyxium

EPIC Cobalt, Diamond, Emerald

RARE Gold, Silver

UNCOMMON Iron

COMMON Coal, Copper

Mob Tiers (wildcard-based classification)

Tier Examples

WORLDBOSS Dragon_Fire, Dragon_Frost

BOSS (Reserved for dungeon bosses)

MINIBOSS Rex_Cave, Werewolf, Shadow_Knight

ELITE Ghoul, Crocodile, Yeti

HOSTILE Zombie, Skeleton_Soldier, Trork

PASSIVE Skeleton, Sheep, Feran

CRITTER Bunny, Chicken, Rat

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 Example Reward

0-50 CRITTER 0-1 Copper

50-100 PASSIVE 1-2 Copper

100-300 HOSTILE 4-10 Copper

300-700 ELITE 2-5 Iron

700-1200 MINIBOSS 2-4 Cobalt

1200+ BOSS 1-3 Gold

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

Zero configuration required - Just install your mod and rewards work automatically!

Building from Source

Requirements: Place JARs in libs/ folder:

hytale-server.jar (Hytale dedicated server)

Ecotale-1.0.0.jar (from Ecotale project)

./gradlew jar Output: build/libs/EcotaleJobs-1.0.0.jar

License

MIT License - 2026 Tera-bytez