JustAPrankBro

# It's Just a Prank Bro **Safe, cinematic prank scenes for trusted Paper server players.** It's Just a Prank Bro is a standalone Paper plugin that lets trusted players trigger short, chaotic, themed prank scenes without risking victim deaths, item loss, block grief, or stranded players. Pranks temporarily move the target into a plugin-managed scene world, play out a staged cinematic set, clean up prank-owned blocks, mobs, and items, then safely return the player to their original location. ## Features - 22 protected cinematic pranks: - Kidnap - Trial - Funeral - Alien Abduction - Game Show - Meteor - Haunted House - Shrink Ray - Cookoff - Execution - Heist - Pirate - Museum - Circus - Detention - Factory - Car Wash - Claw Machine - Bowling - Dentist - Photoshoot - Wrestling - Temporary prank rooms generated in a dedicated scene world. - Recognizable themed sets instead of plain boxes. - Configurable per-prank cooldowns. - Configurable per-prank durations, room sizes, mob counts, pulses, and role mob allowlists. - Single-player selector support, such as `/prank kidnap @p spider`. - Tab completion for players and allowed mob types. - Player opt-out support with `/prank toggle`. - Status visibility with `/prank status`. - Admin reload support with `/prank reload`. - Emergency cleanup support with `/prank panic`. - Configurable active-scene limit. - Configurable disabled worlds. - Configurable creative, spectator, and dead-player skipping. - Safe return search around the original return point. - State persistence for opt-outs, cooldowns, active sessions, return points, and room bounds. - Disconnect, reload, and restart recovery for active prank victims. - Prank-owned mobs, dropped items, and generated rooms are tagged and cleaned up. - Prank-owned dropped items cannot be picked up during active scenes. - Uses supported Bukkit/Paper APIs only. ## Pranks - **Kidnap** stages an ambush, blackout, temporary room wakeup, staged mob threat, second blackout, and safe return. - **Trial** stages an arrest, courtroom hearing, verdict, jail sentence, final blackout, and safe return. - **Funeral** stages a fake collapse, coffin wakeup, chapel viewing, procession, burial, resurrection, and safe return. - **Alien Abduction** stages a beam, UFO lab specimen tube, scan pulses, final blackout, and safe return. - **Game Show** stages a wrong-answer studio scene with host mobs, audience, lights, answer pads, confetti, and a padded pit gag. - **Meteor** stages a fake meteor warning, blackout impact, crater scene, news crew, and harmless release mobs. - **Haunted House** stages a walkable haunted hallway with flickering lights, jump scares, and a finale. - **Shrink Ray** stages an oversized lab with scientist mobs, giant props, specimen observation, and a restore beam. - **Cookoff** stages a giant frying pan, chef mobs, kitchen props, ingredient drops, and a harmless splash finale. - **Execution** stages a medieval scaffold, countdown, trapdoor fake-out, slime-pit landing, and safe return. - **Heist** stages a bank-vault hostage scene with alarm lights, robber crew, breach smoke, and loot props. - **Pirate** stages a ship deck, captain and crew, walk-the-plank fake-out, and splash-pit return beat. - **Museum** stages a gallery, glass display-case wakeup, laser alarm pulses, and shipping-crate boxing. - **Circus** stages a big-top ring, ringmaster, crowd, cannon presentation, and human-cannonball landing gag. - **Detention** stages a classroom, teacher, students, bell beats, punishment platform, and final blackout. - **Factory** stages an assembly-line room with workers, conveyor movement, warning lights, and a fake press finale. - **Car Wash** stages a conveyor wash tunnel with attendants, foam pulses, rinse moves, and dryer blast. - **Claw Machine** stages a giant arcade cabinet with prize props, operator mobs, blinking lights, and a claw gag. - **Bowling** stages a bowling alley pin deck with bowler mobs, score lights, strike fake-out, and gutter gag. - **Dentist** stages a bright clinic chair with staff mobs, exam lamps, and a fake drill gag. - **Photoshoot** stages a studio shoot with photographer mobs, flash pulses, changing backdrops, and a staged crash beat. - **Wrestling** stages a ring scene with wrestler mobs, crowd beats, bell pulses, and a fake slam finale. ## Safety Victims are protected during active prank scenes. Protections include: - Damage prevention. - Death prevention. - Item drop prevention. - Item pickup prevention. - Item durability loss prevention. - Block break prevention. - Block place prevention. - Explosion prevention from prank entities. - Block grief prevention from prank entities. - Drop prevention from prank entities. - Movement locking during scene phases that require it. - Safe teleport return. - Health, food, saturation, exhaustion, fire, fall distance, blindness, slowness, darkness, and levitation cleanup on return. Prank mobs are tagged, controlled, and cleaned up. They cannot freely target unrelated players, damage players, explode blocks, change blocks, or leave item drops behind. ## Commands Main command: - `/prank` Aliases: - `/justaprankbro` - `/prankbro` Prank commands: - `/prank kidnap [mob2] [mob3] [mob4]` - `/prank trial [jailSeconds]` - `/prank funeral [priestMob] [seconds]` - `/prank abduction [seconds]` - `/prank gameshow [seconds]` - `/prank meteor [seconds]` - `/prank haunted [seconds]` - `/prank shrinkray [seconds]` - `/prank cookoff [seconds]` - `/prank execution [seconds]` - `/prank heist [seconds]` - `/prank pirate [seconds]` - `/prank museum [seconds]` - `/prank circus [seconds]` - `/prank detention [seconds]` - `/prank factory [seconds]` - `/prank carwash [seconds]` - `/prank clawmachine [seconds]` - `/prank bowling [seconds]` - `/prank dentist [seconds]` - `/prank photoshoot [seconds]` - `/prank wrestling [seconds]` Utility commands: - `/prank toggle` - `/prank status` - `/prank reload` - `/prank panic` ## Permissions Most permissions default to operator access. Player opt-out access defaults to everyone. Grant all admin access: - `justaprankbro.admin` Core permissions: - `justaprankbro.command` - `justaprankbro.toggle` - `justaprankbro.admin.reload` - `justaprankbro.admin.panic` - `justaprankbro.bypass.cooldown` - `justaprankbro.bypass.exempt` - `justaprankbro.exempt` - `justaprankbro.prank.self` Individual prank permissions: - `justaprankbro.prank.kidnap` - `justaprankbro.prank.trial` - `justaprankbro.prank.funeral` - `justaprankbro.prank.abduction` - `justaprankbro.prank.gameshow` - `justaprankbro.prank.meteor` - `justaprankbro.prank.haunted` - `justaprankbro.prank.shrinkray` - `justaprankbro.prank.cookoff` - `justaprankbro.prank.execution` - `justaprankbro.prank.heist` - `justaprankbro.prank.pirate` - `justaprankbro.prank.museum` - `justaprankbro.prank.circus` - `justaprankbro.prank.detention` - `justaprankbro.prank.factory` - `justaprankbro.prank.carwash` - `justaprankbro.prank.clawmachine` - `justaprankbro.prank.bowling` - `justaprankbro.prank.dentist` - `justaprankbro.prank.photoshoot` - `justaprankbro.prank.wrestling` ## Configuration Server owners can configure: - Whether the plugin is enabled. - Disabled worlds. - Per-prank cooldowns. - Maximum active scenes. - Whether creative, spectator, or dead players can be targeted. - Cleanup behavior on disable. - Safe return search radius. - Maximum generated blocks per session. - Scene world name, room height, room spacing, and base materials. - Per-prank room radius and room height. - Per-prank durations, mob counts, pulses, and allowed role mobs. - Command messages. ## Persistence It's Just a Prank Bro stores lightweight state in the plugin data folder: - Player opt-outs. - Per-prank cooldowns. - Active prank sessions. - Original return locations. - Temporary room bounds. - Session phase data for recovery. It does not require a database, external service, API key, or remote credential. ## Notes This plugin is designed for survival, SMP, event, and roleplay servers that want chaotic player moments with guardrails. Prank trigger permissions should be given only to trusted staff or trusted players. Targets can opt out, admins can exempt players, and emergency panic cleanup is available if a scene needs to be ended immediately.