Frozen Bubble OSCified

Frozen Bubble OSCified is a modified Version of the java port of Frozen Bubble. The game itself hasn't changed that much, but the game sends OSC (Open Sound Control) Messages when certain events occur. The default host/port is 127.0.0.1:57120 (SuperCollider Language). This can be changed with the command line arguments -host [host] -port [port]. The following document describes all available OSC Messages. Please note that some events may seem redundant. Also naming and implimentation is often worse than i wanted it to be, after all it is just a hacked game.

Frozen Bubble OSCified can also be directly controlled over OSC. The game listens by default on port 57180, you can change the port with command line argument -listen [port].

For more information and/or updates please visit http://blog.cappel-nord.de/frozen-bubble/.

States

/fb/state/init

… the Frozen Bubble OSCManager gets initialized.

/fb/state/start

… the game(play) has started.

/fb/state/won

… you have won a level (by clearing all bubbles)

/fb/state/lost

… you have lost a level.

/fb/state/splash

… splash screen is shown.

General Events

/fb/event/frozenify

… the whole screen starts to freeze. The game is about to end. You can use /fb/bubble/frozenify to recieve frozenify Events for each bubble.

/fb/event/lostlife

… you lost a life.

/fb/event/movedown

… all bubbles move on row down. Please note that the bubbles don't send their updated position.

/fb/event/fire

… you fired a bubble.

/fb/event/hurry

… the hurry screen flashes. A /fb/event/fire message ends a hurry phase.

/fb/event/new

… a new map got initalized. All bubbles should be reseted. It is likely that new bubbles spawn after this message

Game Information

/fb/level (int level)

• level: The current level

/fb/life (int lifes)

• lifes: The number of available lifes

/fb/direction (float direction)

• direction: The direction your bubble-gun points to. -1 is the outer left side, 1 is the outer right side.

Bubble Events

The first argument of every bubble message is a unique id (integer). This makes it possible to track several bubbles.

/fb/bubble/spawn (int id, int color, float x, float y)

• color: the color of the bubble.
  • 0: black
  • 1: silver
  • 2: blue
  • 3: green
  • 4: yellow
  • 5: pink
  • 6: red
  • 7: orange
• x: the x-position of the bubble. 0 is the outer left, 1 is the outer right.
• y: the y-positon of the bubble. 1 is on the bottom, 0 is on the top.

… a new bubble is spawned and visible.

/fb/bubble/position (int id, float x, float y)

• x: the x-position of the bubble. 0 is the outer left, 1 is the outer right.
• y: the y-positon of the bubble. 1 is on the bottom, 0 is on the top.

… a bubble did move.

/fb/bubble/rebound (int id, int side, float y)

• side: on which side the rebound occured. -1 = left, 1 = right
• y: the y-positon of the bubble. 1 is on the bottom, 0 is on the top.

… a bubble rebounded on one side.

/fb/bubble/frozenify (int id)

… a bubble has frozen over.

/fb/bubble/stick (int id)

… this moving bubble sticked to other bubbles.

/fb/bubble/fall (int id)

… the bubbles falls down.

/fb/bubble/jump (int id)

… the bubbles jumps, and then falls down. Future Versions may give you a vector in which direction the bubble jumps.

/fb/bubble/delete (int id)

… the bubble is no longer on the screen. it can be deleted!

Controlling Frozen Bubble OSC

Frozen Bubble OSCified doesn't send these messages. They can be send to Frozen Bubble OSCified in order to controll it over OSC.

/fire

… acts like the fire key, as well as the start button.

/step/left

… the shooting device rotates one step to the left.

/step/right

… the shooting device rotates one step to the right.

/stay/left

… the shooting device rotates to the left until another stay message is received.

/stay/right

… the shooting device rotates to the right until another stay message is received.

/stay/release

… the shooting devices stops rotating