Simple Jobs

SimpleJobs

A comprehensive jobs and economy plugin for Hytale servers

SimpleJobs is a feature-rich job system plugin designed specifically for Hytale servers. Players can join various professions, earn experience, level up their skills, and make money through activities like hunting monsters, mining ores, chopping trees, and farming crops. Perfect for RPG servers, economy-focused communities, or any server looking to add progression systems.

Features

Multi-Job System

Four Implemented Jobs - Hunter, Miner, Woodcutter, and Farmer with unique gameplay loops

Leveling & Progression - Each job has its own experience bar and levels (1-100)

Job Switching - Players can join or leave any job at any time

Persistent Progress - All job data saved to database with automatic caching

Hunter Job

Monster Slayer - Earn money by killing hostile mobs and monsters

Tiered Rewards - Different monsters give different base rewards

Level Requirements - Higher-tier monsters require higher job levels

Smart NPC Detection - Only rewards for naturally aggressive mobs

Miner Job

Ore Mining Rewards - Earn money and XP for breaking valuable ores

Automatic Ore Detection - Intelligently identifies ore blocks by name patterns

Six Tiers - Common, Uncommon, Rare, Epic, and Legendary ores with scaled rewards

Tool Quality Bonus - Better tools = better rewards

Block Quality Scaling - Higher quality blocks provide increased rewards

Woodcutter Job

Tree Chopping Rewards - Earn money and XP for harvesting logs

Log Detection - Automatically identifies all types of wood/log blocks

Six Wood Tiers - From common logs to legendary ancient wood

Axe Quality Bonus - Better axes = better rewards

Progressive Scaling - Rewards grow with both tool quality and player level

Farmer Job

Crop Harvesting - Earn money by picking up harvested crops

Crop Recognition - Identifies farming items like Carrots, Wheat, Potatoes, Melons, Pumpkins, and more

Six Crop Tiers - Common crops to legendary varieties

Smart Classification - Auto-classifies crops by name patterns

Perfect for Farm Servers - Reward your agricultural players

Performance & Reliability

Lightning Fast Caching - In-memory caching with Caffeine for instant lookups

Asynchronous Operations - All database operations run in background using Kotlin coroutines

Dual Database Support - SQLite for simple setups, PostgreSQL for large networks

Smart Economy Integration - Seamless deposits via Cassaforte Economy API

Thread-Safe Design - Immutable data models ensure consistency

Developer Friendly

Clean Architecture - Modern codebase following best practices

Comprehensive API - Easy integration for other plugins

Modular Design - Use Cases, Services, and Systems are fully decoupled

Well Documented - Full architecture documentation included

Commands

Player Commands

Command Description Permission

/jobs help Show jobs help message and available jobs jobs.user

/jobs join <job> Join a job (hunter, miner, woodcutter, farmer) jobs.join

/jobs leave <job> Leave your current job jobs.leave

/jobs info View all your jobs and progress jobs.info

/jobs info <job> View detailed info about a specific job jobs.info

Job Types Available

Hunter - Earn money by killing monsters

Miner - Earn money by mining ores

Woodcutter - Earn money by chopping trees

Farmer - Earn money by farming crops

Configuration

SimpleJobs creates configuration files on first launch:

Database Config (jobs_config.json)

SQLite (Default) - Perfect for most servers

{ "database": { "type": "SQLITE", "sqlite": { "path": "jobs_data/jobs.db" } } }

No setup required

File-based storage in jobs_data/jobs.db

Ideal for small to medium servers

PostgreSQL - For high-performance networks

{ "database": { "type": "POSTGRESQL", "postgresql": { "host": "localhost", "port": 5432, "database": "jobs", "username": "jobs_user", "password": "your_password", "poolSize": 10 } } }

Connection pooling for optimal performance

Recommended for servers with large player counts

Jobs Settings (jobs_config.json)

{ "jobs": { "enableLeveling": true, "maxLevel": 100, "baseExperienceMultiplier": 1.0 } }

Permissions

SimpleJobs uses a straightforward permission system:

Player Permissions (granted to all players by default)

jobs.user - Base user permission

jobs.join - Join jobs

jobs.leave - Leave jobs

jobs.info - View job information

Admin Permissions (automatically given to server operators)

jobs.admin - Full administrative access

Leveling System

Experience Formula

Experience required for next level: 100 × level^1.5

Examples:

Level 1→2: 100 XP

Level 10→11: 3,162 XP

Level 50→51: 35,355 XP

Level 99→100: 98,995 XP

Reward Scaling

All rewards scale with player level: baseReward × (1 + level × 0.05)

Example: At level 10, a 10 coin base reward becomes: 10 × (1 + 10 × 0.05) = 15 coins

Integration & API

Economy Integration

SimpleJobs implements the Cassaforte Economy API, ensuring:

Automatic money deposits to player accounts

Consistent economy behavior across plugins

Future-proof compatibility with economy addons

Developer API

val jobs = SimpleJobs.instance

// Get player job data val jobPlayer = jobs.getJobPlayer(playerUuid, JobType.HUNTER)

// Check player level println("Player is Hunter level ${jobPlayer.level}") println("Progress: ${jobPlayer.getLevelProgress()}%")

Getting Started

Install - Place SimpleJobs.jar in your server's plugins/ folder

Install Economy - Ensure SimpleEconomy plugin is also installed

Start Server - Launch your Hytale server

Configuration - Edit jobs_config.json to customize settings

Join a Job - Players use /jobs join <job> to start earning!

Example Gameplay

New Player Experience:

Player: /jobs help Server: === SimpleJobs === Server: Earn money and XP through various jobs! Server: Server: Available Jobs: Server: hunter: Earn money by killing monsters Server: miner: Earn money by mining ores Server: woodcutter: Earn money by chopping trees Server: farmer: Earn money by farming crops

Player: /jobs join hunter Server: You joined the Hunter job! Server: Description: Earn money by killing monsters

Player: /jobs info hunter Server: === Hunter Job === Server: Description: Earn money by killing monsters Server: Your Progress: Server: Level: 1 Server: Experience: 0.0 / 100.0 Server: Progress: 0.0% Server: Total Earnings: 0.00 After Killing a Mob:

Console: [Hunter] Player killed Mob - +10 XP, +5 coins Player: +10 XP (Hunter) Player: +5 coins added to your balance

Requirements

Java 25+ - Required for Hytale server plugins

SimpleEconomy Plugin - Required for money rewards and deposits

Hytale Server - Latest recommended version

Technical Details

Language: Kotlin

Architecture: Clean Architecture with Use Cases

Database: SQLite / PostgreSQL with exposed ORM

Caching: Caffeine (in-memory cache)

Concurrency: Kotlin Coroutines

Build Tool: Gradle with Shadow plugin

Future Enhancements

Planned features for future releases:

Fisherman Job - Catch fish and earn rewards

Job Leaderboards - Top players for each job type

Daily Quests - Job-specific challenges

GUI Interface - Visual job selection and progress viewing

Credits

Built for the Hytale modding community.

Integrates with Cassaforte's Economy API for seamless economy management.