HireHall

Player to player hiring for your server. Post a job, the pay is held safely, another player does the work and gets paid.

Read the docs Get it

Paper, Purpur and Folia
Minecraft 1.21.1 and newer
Seven job goals
9 currency hooks
Every menu editable

Features

What is in the box

Every card goes to the page that documents it, config keys and all.

Jobs and job types

Delivery jobs and six kinds of task job, all set up in job-types.yml.

Posting a job

A step by step menu from job type to deadline, with a note and an optional offer.

Escrow and claims

The pay is held the moment a job is posted and paid out through claims.

Currencies

Vault, PlayerPoints, CoinsEngine and more, plus a custom provider.

Direct offers

Offer a job to one player and choose what happens if they decline.

Ratings and profiles

One to five stars per job and a profile with totals per currency.

Menus

Every menu is a yml file with slots, fillers, templates and actions.

Admin tools

Force complete, cancel, inspect and wipe, all written to an admin log.

Why HireHall

Hiring that players can trust

The pay is safe from the first click

Money and items leave the employer when the job is posted and are held until the job ends. Nobody can spend them twice.

Every payout goes through claims, so nothing is ever dropped on the ground and nothing is lost when a player is offline.

How escrow works

The employer posts a job, the money and items move into escrow, then a completed job becomes a Payment claim for the worker and a cancelled or expired job becomes a Refund claim for the employer

Work that counts fairly

Blocks players placed never count for mining, crops only count when fully grown, and spawner mobs can be left out.

Delivered items are checked for the right material, custom item, name, enchantments and model data.

How progress is counted

Four cards: placed blocks never count for mining, farming only counts fully grown crops, spawner mobs can be left out, and creative or spectator players make no progress

Every menu is yours to change

Every menu is a yml file with slot ranges, fillers, templates, pagination and click actions. Drop in your own menu files too.

The menu file format

Inside the docs

Drawn, not just described

The pages carry diagrams of the parts that are easier to see than to read.

A flow of job states from Post Job to Open or Offered, then In progress, Ready to hand in and Completed, with abandon, decline, expired and cancelled paths

The job lifecycle

Open, offered, in progress, ready to hand in and completed.

Open the page

Eight cards in two rows for the posting menus: type, goal, amount, payment, currency, items, deadline and confirm, with the paths for money only and items only

Posting a job

The eight posting menus and which ones each payment mode uses.

Open the page

Quick start

Running in a few minutes

1
Drop in the jar
Put HireHall in your plugins folder next to your economy plugin.
2
Start the server
HireHall writes its files and logs which currencies it hooked.
3
Check currencies
Turn off the currencies you do not use in currencies.yml.
4
Post a job
Open /hirehall and post a test job, then take it on a second account.

Full installation guide

No setup is needed to try it. Tune limits, currencies and menus later.

Everything is documented

Every config key, every command and every permission has a page. If something is still unclear, ask in the Discord.

Read the docs Download Get support

HireHall is by zArrowTan. The Discord is the only support channel, there is no public issue tracker.