SnowballGame 1.1.1

Tested Minecraft Versions:

• 1.10
• 1.11
• 1.12

Source Code:

https://github.com/kanesada2/SnowballGame

SnowballGame is a plugin to play baseball in Minecraft.
This plugin provides three items:Ball, Bat, and Glove.
Ball :

a customized snowball which bounce when hit to blocks, and dropped as a item when hit to entities.
SnowballGame provides five type of balls:Highest-repulsion, Higher-repulsion, Normal, Lower-repulsion, Lowest-repulsion.
They behave different when you hit them with a Bat.
Defining Normal-ball's speed as 1.0, their speeds are:

Highest: 1.4
Higher: 1.2
Normal: 1.0
Lower: 0.8
Lowest: 0.6​

If you want to pitch breaking ball, you should name your ball to specific name(defined in config.yml) by the anvil before you pitch.
Default config is below.​

Bat :

a customized bow which can't shoot any arrows but can hit Ball and send it far away.
You need to prepare at least one arrow if you try to use it in Survival-mode.
Although Bat won't shoot any arrows, an arrow needs to draw this-customized-bow.​

Glove:

a customized leather. If you set it at your off-hand, you can "catch" Ball hitting to you.​

Umpire:

a high-spec home base. When the ball go through above it, it'll call "STRIKE" on chat. You can set the bottom-line of strike zone and top-line in Config.​

Coach:

a customized armor-stand. He help you with your fielding practice to hit the ball toward you.
When you want to practice, you should send /sbg please command or throw a ball at him.
When he hit the ball from dispenser, batted-ball will go towards random-player(equipping glove in off-hand) near him.It will help your situational-practice.
​

Tee:

This is not a customized-item.
You can use brewing-stands as batting tees.
Pointing to a brewing-stand and right-clicking it with Balls, the Ball entity will be placed on it.
You can hit that by your Bat.​

Tutorial video




Recipes of SnowballGame's items




Commands:

• /snowballgame(/sbg) display all commands of SnowballGame.
• /sbg reload reload SnowballGame.
• /sbg get [ball/bat/glove] <ball_type> give a selected item to sender of this command.
• /sbg please The coach nearby you will hit the ball toward you.You have to have at least one ball when you send this command.

Permissions:

• snowballGame.* Gives all SnowballGame permissions
• snowballGame.reload Allows you to reload SnowballGame's config
• snowballGame.get Allows you to get SnowballGame's items
• snowballGame.please Allows you to practice fielding with the "Coach".

Configurations:

Spoiler: config.yml

Code (Text):

# SnowballGame Config
####

# true/false (If true, snowballs will cause knockback to players when they hits.)
Knockback_For_Players: true
Ball:
    # true/false(If true, players can use custom snowball which behave like a ball for baseball.)
    Enabled_Ball: true
    # 'BallName' (Default name to display for the custom snowball)
    Ball_Name: 'Ball'
    # Natural number (Once you threw ball, you can't throw the next ball in this time.(Ticks))
    Cool_Time: 30
    Move:
        # The type of moving balls.
        Type:
          - 'Fast'
          - 'Slider'
          - 'Curve'
          - 'Folk'
          - 'Sinker'
          - 'Shuuto'
          - 'Knuckle'
        # The feature of each type of moving balls defined above lines.
        # Velocity: positive number which will be multiplied by default ball's velocity(the default is about 108-110km/h.)
        # Vertical: the vertical movement of the ball. a positive value makes the ball move up.
        # Horizontal: the horizontal movement of the ball. a positive value means the direction of your main-hand side.
        # Acceleration: the acceleration of the ball. If this value is positive, the ball will lose less speed than the ordinal snowball.
        # Random: the movement with random direction.
        Fast:
            Velocity: 1.1
            Vertical: 0.01
            Horizontal: 0
            Acceleration: 0.01
        Slider:
            Velocity: 1
            Vertical: -0.005
            Horizontal: -0.02
            Acceleration: 0
        Curve:
            Velocity: 0.9
            Vertical: -0.02
            Horizontal: -0.02
            Acceleration: -0.01
        Folk:
            Velocity: 1
            Vertical: -0.02
            Horizontal: 0
            Acceleration: 0
        Sinker:
            Velocity: 0.9
            Vertical: -0.02
            Horizontal: 0.02
            Acceleration: -0.01
        Shuuto:
            Velocity: 1
            Vertical: -0.005
            Horizontal: 0.02
            Acceleration: 0
        Knuckle:
            Velocity: 0.9
            Random: 0.02
            Vertical: -0.02
            Horizontal: 0
            Acceleration: -0.02
    # the names of the balls which have different repulsion with being hit.
    Repulsion:
        Highest: 'Ball'
        Higher: 'Ball'
        Lower: 'Ball'
        Lowest: 'Ball'
Bat:
    # true/false (If true, players can use custom bow which behave like a bat for baseball.)
    Enabled_Bat: true
    # 'BatName' (Default name to display for the custom bow)
    Bat_Name: 'Bat'
    # You can change your swing by naming special name(set below) to your bat.
    # Fly: (-1~1) Bigger value means you can hit high-fly easily, and smaller means batted-ball tends to be grounder. Default value is 0.
    Swing:
        Type:
            - UPPER
            - DOWN
        UPPER:
            Fly: 0.3
        DOWN:
            Fly: -0.3
Glove:
    # true/false (If true, players can use custom leather which behave like a bat for baseball.)
    Enabled_Glove: true
    # 'GloveName' (Default name to display for the custom leather)
    Glove_Name: 'Glove'
    Custom:
        Type:
            - SIDE
            - SUBMARINE
        # You can custom your release-point in pitching.A named glove make you other type of pitcher.
        # Vertical: 0 means the height of your eye. positive value means above.
        # Horizontal: 0 means the position of your eye. positive value means your main-hand side..
        # Closeness: Increasing this value means you can pitch from closer to batter.
        SIDE:
            Vertical: -0.5
            Horizontal: 0.3
            Closeness: 0
        SUBMARINE:
            Vertical: -1.3
            Horizontal: 0
            Closeness: 0
Umpire:
    # true/false (If true, players can summon custom Armor_Stand which call "Strike" when the ball through Strike-zone.)
    Enabled_Umpire: true
    # 'UmpireName' (Default name to display for the custom Armor_Stand)
    Umpire_Name: 'Umpire'
    # the height(from the ground) of the top of the strike-zone.
    Top: 1.7
    # the height(from the ground) of the bottom of the strike-zone.
    Bottom: 0.5
Base:
    # true/false (If true, players can place a base which is useful for jugding safe or out.)
    Enabled_Base: true
    # 'UmpireName' (Default name to display for the custom Armor_Stand)
    Base_Name: 'Base'
Coach:
    # true/false (If true, players can summon custom Armor_Stand which hit the ball when you practice fielding.)
    Enabled_Coach: true
    # 'CoachName' (Default name to display for the custom Armor_Stand)
    Coach_Name: 'Coach'
    # The limit of "/sbg please" command
    Coach_Range: 120
Broadcast:
   # About the message of swinging a bat.
   Swing:
       Enabled: true
       Range: 50
       Message: '[[YELLOW]][[BOLD]]*** [[PLAYER]] SWINGS ***'
   # About the message of trying to bunt(swing gently)
   Bunt:
       Enabled: true
       Range: 50
       Message: '[[GREEN]][[BOLD]]*** [[PLAYER]] TRIES TO BUNT ***'
   # About the message of hitting a ball with a bat.
   Hit:
       Enabled: true
       Range: 100
       Message: '[[DARK_RED]][[BOLD]]*** [[PLAYER]] HITS THE BALL ***'
   # About the message of tagging a runner (hit a runner with a ball in main-hand)
   Tag:
       Enabled: true
       Range: 50
       Message: '[[BLUE]][[BOLD]]*** [[PLAYER]] TAGS [[RUNNER]] ***'
   # About the message of catching a batted-ball in flight.
   Catch:
       Enabled: true
       Range: 100
       Message: '[[LIGHT_PURPLE]][[BOLD]]*** [[PLAYER]] CATCHES THE BALL ***'
   # About the message of "Strike" call.
   Strike:
       Range: 100
       Message: '[[YELLOW]][[BOLD]]*** STRIKE [[SPEED]] [[TYPE]]  PITCHED BY [[PLAYER]]***'
   # About the message of runner reaching the base.
   Reach_Base:
       Enabled: true
       Range: 50
       Message: '[[RED]][[BOLD]]*** [[PLAYER]] REACHES THE BASE ***'
   # About the message of fielder touching the base with holding a ball.
   Touch_Base:
       Enabled: true
       Range: 50
       Message: '[[DARK_PURPLE]][[BOLD]]*** [[PLAYER]] TOUCHES THE BASE ***'
#If you want to know about the format of "Particle" section, you should see https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
Particle:
    # When a player catch the ball with his glove.
    Catch_Ball:
        Enabled: false
        Particle: CRIT_MAGIC
    Throw_Ball:
        Enabled: false
        Particle: SNOWBALL
    # When a ball hit to a player.
    Hit_to_Players:
        Enabled: false
        Particle: CRIT
    # When a player swings his bat.
    Swing_Bat:
        Enabled: true
        Particle: SWEEP_ATTACK
    # If true, the particle will track your swing(But it's just a guide.)
    Swing_Bat_Sequent:
        Enabled: false
        Particle: VILLAGER_HAPPY
    # When a player slugs a ball with his bat.
    Hit_by_Bat:
        Enabled: false
        Particle: EXPLOSION_LARGE
    # During a batted-ball is going in flight.
    BattedBall_InFlight:
        Enabled: false
        Particle: FIREWORKS_SPARK
    # When a batted-Ball ground on something at the first time."Time" value means how long the particle will being shown.
    BattedBall_Ground:
        Enabled: true
        Particle: SNOW_SHOVEL
        Time: 200
    # When a player pitch a specific moving-ball.You can set the type of particles in each ball's section.
    MovingBall:
        Enabled: true
 

The Example of adding changeup:

Spoiler: edited ball's moving section

Code (Text):

    Move:
        # The type of moving balls.
        Type:
          - 'Fast'
          - 'Slider'
          - 'Curve'
          - 'Folk'
          - 'Sinker'
          - 'Shuuto'
          - 'Changeup'
        # The feature of each type of moving balls defined above lines.
        # Velocity: positive number which will be multiplied by default ball's velocity(the default is about 108-110km/h.)
        # Vertical: the vertical movement of the ball. the positive value makes the ball move up.
        # Horizontal: the horizontal movement of the ball. the positive value means the direction of your main-hand side.
 
Fast:
            Velocity: 1.1
            Vertical: 0.01
            Horizontal: 0
            Acceleration: 0.01
        Slider:
            Velocity: 1
            Vertical: -0.005
            Horizontal: -0.02
            Acceleration: 0
        Curve:
            Velocity: 0.9
            Vertical: -0.02
            Horizontal: -0.02
            Acceleration: -0.01
        Folk:
            Velocity: 1
            Vertical: -0.02
            Horizontal: 0
            Acceleration: 0
        Sinker:
            Velocity: 0.9
            Vertical: -0.02
            Horizontal: 0.02
            Acceleration: -0.01
        Shuuto:
            Velocity: 1
            Vertical: -0.005
            Horizontal: 0.02
            Acceleration: 0
        Changeup:
            Velocity: 1
            Vertical: 0.015
            Horizontal: 0.01
            Acceleration: -0.02
 

You can pitch the changeup if you name the ball 'Changeup'.

Broadcast section:

you can change the color of messages.
Supported colors are:

[[BLACK]],[[DARK_BLUE]],[[DARK_GREEN]],[[DARK_AQUA]],
[[DARK_RED]],[[DARK_PURPLE]],[[GOLD]],[[GRAY]],
[[DARK_GRAY]],[[BLUE]],[[GREEN]],[[AQUA]],
[[RED]],[[LIGHT_PURPLE]],[[YELLOW]],[[WHITE]]​

and text-decorations are:

[[BOLD]],[[UNDERLINE]],[[ITALIC]],[[STRIKE]],[[MAGIC]]​

any colors and decorations will be reset with writing [[RESET]].
[[PLAYER]] will be replaced to the name of player doing that action,
and [[RUNNER]] in the "Tag" section will be the "tagged"(hit by the player who has the Ball in his main-hand) player's name in message to broadcast.​

Particle:

You can set the particle shown in some plays on SnowballGame.
The available names of particles is https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
And also you can make the original moving-ball with particles.
If you want, you should set "Particle.MovingBall.Enabled" true and add "Particle:" section and value in your moving ball.
The Example of adding FireBall is shown below.​

Spoiler: FireBall adding Example

Code (Text):

### (OMITTED) ###
    Move:
        # The type of moving balls.
        Type:
          - 'Fast'
          - 'Slider'
          - 'Curve'
          - 'Folk'
          - 'Sinker'
          - 'Shuuto'
          - 'FireBall'
        # The feature of each type of moving balls defined above lines.
        # Velocity: positive number which will be multiplied by default ball's velocity(the default is about 108-110km/h.)
        # Vertical: the vertical movement of the ball. a positive value makes the ball move up.
        # Horizontal: the horizontal movement of the ball. a positive value means the direction of your main-hand side.
        # Acceleration: the acceleration of the ball. If this value is positive, the ball will lose less speed than the ordinal snowball.
        Fast:
            Velocity: 1.1
            Vertical: 0.01
            Horizontal: 0
            Acceleration: 0.01
        Slider:
            Velocity: 1
            Vertical: -0.005
            Horizontal: -0.02
            Acceleration: 0
        Curve:
            Velocity: 0.9
            Vertical: -0.02
            Horizontal: -0.02
            Acceleration: -0.01
        Folk:
            Velocity: 1
            Vertical: -0.02
            Horizontal: 0
            Acceleration: 0
        Sinker:
            Velocity: 0.9
            Vertical: -0.02
            Horizontal: 0.02
            Acceleration: -0.01
        Shuuto:
            Velocity: 1
            Vertical: -0.005
            Horizontal: 0.02
            Acceleration: 0
        Fast:
            Velocity: 1.2
            Vertical: 0.02
            Horizontal: 0
            Acceleration: 0.02
            Particle: FLAME

### (OMITTED) ###

Particle:

    ### (OMITTED) ###

    # When a player pitch a specific moving-ball.You can set the type of particles in each ball's section.
    MovingBall:
        Enabled: true
 

​

You can pitch the fast ball with flames with naming "FireBall.
​

For Developpers

APIs and Events are available, but I haven't write document for them. Please read code from: https://github.com/kanesada2/SnowballGame
They're still weak and hard to use...I'll try HARD.​