CooLJobs - Job & Faction System | Leaders, Invites, GUI & PlaceholderAPI

CooLJobs

A lightweight, no-database job and faction system for Paper, Purpur and Spigot.

Why CooLJobs?

Tired of faction plugins that need a MySQL server just to say hello? CooLJobs gives your server real jobs and factions - Police, Taxi, or anything you dream up - with leaders, member management and an in-game menu, all running on simple, editable YAML files. No database, no setup, works right out of the box.

Features

- Fully custom jobs: define as many as you want in jobs.yml, each with its own leader/member prefix and color codes.
- Leader system: admins promote a leader with one command, and from there the leader manages their own team.
- Invite, accept and reject flow: leaders invite players, who get a clean chat prompt to accept or reject. Invites expire automatically so nothing lingers forever.
- Kick command: leaders can remove a member from their own job, and tab-completion only ever suggests names from their own team.
- In-game member list menu: /cjob members <job> opens a menu with every member's real head (skin-accurate, works great with SkinRestorer) and a Close button.
- One job per player: keeps things simple - joining a new job automatically leaves the old one.
- PlaceholderAPI support (optional): three ready-to-use placeholders for job name, job leader and job prefix, usable in any scoreboard, tab list or chat plugin.
- Fully editable messages: every message in the plugin, including errors, are in messages.yml with color code and placeholder support.
- Reload without restarting: /clj reload reloads the config, jobs, messages and data instantly.
- No required dependencies: runs perfectly with or without PlaceholderAPI installed.

Commands

/clj reload - reloads config.yml, jobs.yml, messages.yml and data.yml, no restart needed (permission: clj.reload)
/clj leader <player> <job> - sets a player as the leader of a job (permission: clj.leader) (Default: OP)
/cjob leave - leaves your current job
/cjob invite <player> - invites a player to your job, leaders only (permission: clj.invite)
/cjob accept - accepts a pending job invite
/cjob reject - rejects a pending job invite
/cjob kick <player> - kicks a member from your job, leaders only (permission: clj.kick)
/cjob members <job> - opens a menu showing every member of a job

Placeholders (requires PlaceholderAPI, optional)

%cjob_jobname% - the player's current job name
%cjob_leaderjob% - the name of that job's leader
%cjob_prefix% - the player's job prefix (leader or member prefix, or a configurable default when they have no job in jobs.yml)

Configurable files

- config.yml: invite expiration time
- jobs.yml: define every job, its prefixes or add a new job
- messages.yml: every message in the plugin, with color code and placeholder support
- data.yml: local storage of leaders and members, managed automatically (It is recommended that you do not touch)

Compatibility

Paper, Purpur and Spigot, versions 1.20 through 26.2. Requires Java 17 or higher.

Also check out my other plugin, CooLCompass

Found a bug or have a feature request? Post it in the Discussion tab below, I read every message.