CrimeGames

# 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: ```text /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: ```text /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: ```text /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 ```text /cg create <type> <id> /cg delete <id> /cg move <id> /cg list /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> /cg resetcooldown <id|bankId> /cg stats /cg cooldowns /cg bank <bankId> /cg logs /cg top <success|profit|fails> /cg reload ``` ## Object Types ```text 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 ```text 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: ```text %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 ```text 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 `