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 <player|selector> <mob> [mob2] [mob3] [mob4]
• /prank trial <player|selector> <judgeMob> <guardMob> [jailSeconds]
• /prank funeral <player|selector> <mournerMob> [priestMob] [seconds]
• /prank abduction <player|selector> <alienMob> [seconds]
• /prank gameshow <player|selector> <hostMob> [seconds]
• /prank meteor <player|selector> <reporterMob> [seconds]
• /prank haunted <player|selector> <ghostMob> [seconds]
• /prank shrinkray <player|selector> <scientistMob> [seconds]
• /prank cookoff <player|selector> <chefMob> [seconds]
• /prank execution <player|selector> <executionerMob> [seconds]
• /prank heist <player|selector> <robberMob> [seconds]
• /prank pirate <player|selector> <captainMob> [seconds]
• /prank museum <player|selector> <curatorMob> [seconds]
• /prank circus <player|selector> <ringmasterMob> [seconds]
• /prank detention <player|selector> <teacherMob> [seconds]
• /prank factory <player|selector> <foremanMob> [seconds]
• /prank carwash <player|selector> <attendantMob> [seconds]
• /prank clawmachine <player|selector> <operatorMob> [seconds]
• /prank bowling <player|selector> <bowlerMob> [seconds]
• /prank dentist <player|selector> <dentistMob> [seconds]
• /prank photoshoot <player|selector> <photographerMob> [seconds]
• /prank wrestling <player|selector> <wrestlerMob> [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.