CrimeGames

CrimeGames adds skill-based crime mechanics to Paper and Purpur servers: ATMs, bank computers, vault terminals, safes, registers, evidence lockers, cameras, black market terminals, cooldowns, police alerts, rewards, stats, placeholders, and public API events.

It is built for servers that want crime gameplay to be an actual system, not just random cooldowns and vague roleplay rules.

Features

• Create interactable crime objects in-game with /crimegames or /cg.
• Skill-based minigames for hacking, lockpicking, vault terminals, safes, registers, cameras, documents, contraband, armored truck panels, and more.
• Short per-target reaction windows in GUI minigames: if the target moves before you click it, it counts as a mistake.
• Bank groups with shared cooldowns, last robbed timestamps, server-time display, and police requirements.
• Reward and penalty commands with placeholders like %player%, %object_id%, %amount%, %world%, %x%, %y%, %z%.
• SQLite persistence for cooldowns, stats, logs, and robbery history.
• PlaceholderAPI expansion included when PlaceholderAPI is installed.
• LuckPerms role detection for police/criminal setups.
• Vault economy support when Vault or VaultUnlocked is installed.
• Optional bridges for DiscordSRV, WorldGuard, ItemsAdder, Oraxen, Citizens, and generic role/gang plugins through permissions, commands, and config.

Compatibility

• Minecraft: 1.21.8 through 1.21.11
• Server software: Paper or Paper-compatible forks such as Purpur
• Java: 21+
• Client mods: not required

CrimeGames does not use NMS or version-specific internals.

Optional Plugins

CrimeGames works by itself, but these plugins unlock extra behavior:

• PlaceholderAPI: scoreboard/menu placeholders.
• LuckPerms: police/criminal role groups.
• Vault or VaultUnlocked: direct economy payouts.
• EssentialsX or another economy provider: useful with Vault.
• DiscordSRV: alert bridge through configured commands.
• WorldGuard: region-aware server setups.
• ItemsAdder/Oraxen: custom item or block display IDs.
• Citizens: NPC-driven crime interactions through commands/config.

Missing optional plugins will not stop CrimeGames from loading.

Quick Start

Put the jar in your server plugins/ folder and restart the server.

Create your first ATM:

/cg create ATM atm_spawn ARMOR_STAND
/cg set police-required atm_spawn false
/cg set reward atm_spawn success eco give %player% 250

Right-click the ATM display to start the minigame.

Create a bank computer:

/cg create BANK_COMPUTER bank_pc ARMOR_STAND
/cg set bank bank_pc spawn_bank

Right-click the bank computer to view server time, last robbed time, and cooldown. Sneak-right-click it to start its assigned minigame.

Use player heads or invisible hitboxes for nicer builds:

/cg create ATM atm_head PLAYER_HEAD head:NeonDeveloper
/cg create STORE_SAFE safe_hitbox INVISIBLE_HITBOX vanilla:IRON_BLOCK
/cg create BLACK_MARKET_TERMINAL terminal_display ITEM_DISPLAY vanilla:ENDER_EYE

Useful Commands

/cg create <type> <id> [display] [displaySpec]
/cg delete <id>
/cg move <id>
/cg list [type]
/cg info <id>
/cg set minigame <id> <minigame>
/cg set cooldown <id> <duration>
/cg set bank <id> <bankId>
/cg set reward <id> <success|fail> <command>
/cg set reward-add <id> <success|fail> <command>
/cg set police-required <id> <true|false>
/cg set police-radius <id> <blocks>
/cg set display <id> <display> [displaySpec]
/cg resetcooldown <id|bankId>
/cg stats [player]
/cg cooldowns
/cg bank <bankId>
/cg logs
/cg top <success|profit|fails>
/cg reload

Object Types

ATM
BANK_COMPUTER
VAULT_TERMINAL
VAULT_DOOR
CASH_REGISTER
STORE_SAFE
WAREHOUSE_CRATE
JEWELRY_CASE
EVIDENCE_LOCKER
CAMERA_PANEL
BLACK_MARKET_TERMINAL
LOCKED_DOOR
LOCKED_CHEST
CAR_LOCK
SERVER_RACK
PAYPHONE
DROP_POINT
DOCUMENT_DESK
FORGERY_TABLE
ALARM_BOX
DRUG_LAB
CONTRABAND_SCANNER
TRAIN_CARGO
ARMORED_TRUCK_MARKER

Minigames

POP_THE_LOCK
WIRE_BYPASS
PIN_CRACK
SIGNAL_TRACE
SAFE_DIAL
CAMERA_LOOP
EVIDENCE_SORT
VAULT_SYNC
LOCKPICK_GRID
LASER_PATH
PASSWORD_PHISH
SERVER_BREACH
REGISTER_SNATCH
DOCUMENT_FORGE
CONTRABAND_PACK
TRACKER_REMOVE
ARMORED_TRUCK_PANEL
BLACK_MARKET_DEAL

PlaceholderAPI

Available when PlaceholderAPI is installed:

%crimegames_heat%
%crimegames_last_success%
%crimegames_last_fail%
%crimegames_bank_cooldown_<bank>%
%crimegames_bank_last_robbed_<bank>%
%crimegames_active_robbery%
%crimegames_total_success%
%crimegames_total_fail%
%crimegames_role%

Permissions

crimegames.admin
crimegames.play
crimegames.police
crimegames.criminal
crimegames.stats.self
crimegames.stats.others
crimegames.bypasscooldown
crimegames.bypassregion
crimegames.reload

Notes

• Economy can be handled with reward commands, Vault, or both.
• For solo testing, disable police requirements on objects with /cg set police-required <id> false.
• Cooldowns are enforced for OPs by default. Only grant crimegames.bypasscooldown to users who should intentionally skip them.
• /cg set reward ... replaces that reward command list. Use /cg set reward-add ... when you intentionally want multiple commands.
• For RP servers, keep police requirements enabled and assign crimegames.police through your permissions plugin.
• Display specs support vanilla:MATERIAL and head:PlayerName. ItemsAdder and Oraxen display specs can be used when those plugins are installed.