BasketballCourts

BasketballCourts

Description

This plugin allows users to create basketball courts and play games on those courts. It's a pretty simple concept, really.

Notice

As this is my first ever Bukkit plugin, I'd say I'm quite proud of this one. Please feel free to leave comments, suggestions, and advice. I have enjoyed working on this project, and I hope this opens up more opportunities for me to write plugins in the future. Thanks to any who have answered questions and helped solve problems so far, and thanks in advance to those who will help me out further down the road! Also note that this plugin is not perfect by any means, but works fine if you use it correctly.

Command Instructions and Features

• A user (with permission bb.*) can create a basketball court with the command /bb create <court_name>.
  • The court is automatically built.
    • The court's center is located at the player's feet.
    • The court is rotated to player's facing.
    • Courts cannot be broken by hand, nor can blocks be placed on them (unless you use WorldEdit).
    • All blocks within 6 blocks above the court's floor will be removed.
    • The court will not build if another court is too close or if a court with that name already exists.

• A user (with permission bb.*) can delete an existing basketball court with the command /bb delete <court_name>.
  • The court will automatically be removed.
  • Previously existing blocks are not restored.

• A user can view a list of existing courts with the command /bb list.

• A user can join a game with the command /bb join <court_name>.
  • Courts have 6 player slots.
  • A player cannot join a full court.
  • A player's inventory, location, and other important data is stored.
  • A player is automatically placed on the team with less players.
    • The player's helmet is set to a block of wool representing the team color.
  • Users can only leave a court by using the command /bb leave as no other commands will work while in a basketball game.
  • If a user quits while in a game or the server shuts down, don't worry. Players are all made to leave the court and have their data restored.

Playing the Game

• A game automatically starts once a second player joins a court.
  • A user (with permission bb.*) can force-start a game with the command /bb start <court_name>.
• All players on a court will see that court's scoreboard.
• When a game starts, a snowball is dropped at center court.
• Whoever picks up the ball has the ball. Makes sense.
  • While holding the ball, sneak to charge the power meter.
    • Right click while charging to shoot.
    • If you are not sneaking the ball will just fall at your feet.
  • If a player has the ball and they leave the court or quit, the ball is dropped at their location.
  • Any items picked up on the court will be removed if they are not the game ball.
• The ball will not break (kinda) when it hits an entity, so if it is still in play, it can be picked up again.
  • If the ball is thrown out of bounds, everyone will be reset and the ball will drop at center court.
  • If the ball (dropped item) is stuck somewhere where nobody can reach, don't worry. It will reset itself at center court after 7 seconds.
• Hit (left-click) the ball holder for a chance to knock the ball away from them.
• When a ball makes it into a goal (hopper), the score is updated, players are reset, and ball is dropped at center court.
  • When a team reaches 21 points, game is over!
  • Players are returned to their previous state upon game end.
  • A court's scoreboard is reset when a game ends or all players leave the court.

Permissions

• bb.* - Basketball admin permission - default to ops

TODO

• Add options for configuration
  • Default max-slot size
  • Prizes (with economy)
  • Default max score
  • etc.
• More less important stuff