Returns a handle to the ScriptData relating to the script that's currently running.

Initialise a previously uninitialised blob.  This is only useful (or safe) for blobs initialised with .server_CreateBlobNoInit()

Get the current health of a blob.

Get the initial health of a blob set in the config file.

Get the current position of a blob.

Get the previous (last frame) position of a blob.

Get the interpolated position of a blob, useful during rendering at uncapped framerates.  You should use this when visually tracking a blob.  Linear interpolation of the ShapeVars old position and new position using getInterpolationFactor().

Set the position of a blob.  If this is done clientside for a player's blob it will be synced.  If this is done serverside for any other blob it will be synced.

Get the current velocity of a blob.

Get the previous frame's velocity of a blob.  (useful just after you collided with a wall, or the ground)

Get the current position of a blob.

Apply a force to the blob. (Physically speaking this function is more similar to an impulse than a force) A force accelerates a blob inversely proportional to it's mass, meaning lighter objects move more when the same force is applied.

Apply a force to the blob at a specific position.  This will invoke a torque as well if the position isn't the object's centre of mass.

Warning: This function has not been used internally.

See Also: CBlob.AddForce, CBlob.AddTorque

Apply a torque to the blob.  A torque rotates a blob inversely proportional to it's mass, meaning lighter objects spin more when the same torque is applied.

Get the radius of the blob.

Note: for polygon shapes this equates to the maximal distance of any point to the centre of the blob.

Get the width of the blob.

Note: this doesn't take into account rotation.

Get the height of the blob.

Note: this doesn't take into account rotation.

Set the rotation of the blob.

If this is done clientside for a player's blob it will be synced.  If this is done serverside for any other blob it will be synced.

Get the rotation of the blob.

Set the rotation of the blob.

If this is done clientside for a player's blob it will be synced.  If this is done serverside for any other blob it will be synced.

Get the rotation of the blob.

Set the rotational speed of the blob.

Get the speed at which this blob is rotating.

Get the mass of the blob.  This describes how physically heavy the blob is.

Set the mass of the blob.

Note: This can cause all sorts of physical strangeness and is only included for completeness.

Set if the blob should be rendered at all.

Hard-Kill this blob, erase it from the world.

Does not gib the blob, but does cause any onDie hooks to be run.

Returns whether or not the blob is active and ticking.

Disables the body so it doesn't run any ticks.

If the blob is collideable at all, or not.

Note that this doesn't necessarily mean everything will collide with it.

Get if the blob counts as a ladder or not.

Get if the blob has any "platform" collision information.

Returns position of blob with offset (corrected by facing)

Get the screen position of the blob.

Get the interpolated screen position of the blob, see getInterpolatedPosition.

Returns Vec2f - the interpolated screen position

Get directional facing information.

Set directional facing information.

Get collision information.

Get collision information.

Get collision information.

Get collision information.

Find out if we're overlapping any ladder blobs.

See Also: CBlob.isLadder

Find out if we were overlapping any ladder blobs in the last tick.

See Also: CBlob.isOnLadder

Get collision information.

Get collision information.

Get collision information.

Get collision information.

Returns snap to grid variable from CShape.

Find out if a blob overlaps a specific point.

Remove a script from this blob.

Add a script to this blob.

Check if a blob has a script added or not. This is not very performant, and slows down the more scripts are present on a blob. don't use this as an "every frame" feature-detection if you can help it - tags or bool properties will be between 10 and 100 faster.

Set the appearance of this object in the inventory.

Note: you should probably set this in the config file unless you want to change it dynamically.

Get the blob we're currently ignoring collisions with, if any.

Put the passed blob into our inventory if possible.

Remove the passed blob from our inventory if possible.

Attempt to remove a blob from our inventory by name, getting a handle to the blob removed if successful.

Removes blob from all inventory it might be in.

Check if a given blob can be put in our inventory at the moment.

Check if a given blob can access our inventory at the moment.

Set the quantity stored in this blob (eg in a stack of materials).

This allows you to avoid having 1000s of blobs when you want to use them as materials, currency, or ammunition.

This will be synced to all clients.

Get the quantity stored in this blob (eg in a stack of materials).

See Also: CBlob.server_SetQuantity

Get the maximum quantity that may be stored in this blob.

Use this on the client or anywhere you don't want to be modifying maxQuantity to avoid slip-ups.

Get the name of this blob when viewed inside the inventory.

Set the name of this blob when viewed inside the inventory.

Find out if this blob is inside an inventory.

Get the blob that has this blob in it's inventory, if any.

Find out if this blob can be picked up by another blob

Set this blob to render for the HUD.

Set this blob to render for the HUD.

Set this blob to render for the HUD.

Find out how many blobs we're touching.

MM: "touchy touchy"

Get one of the blobs touching us by arbitrary index.

Get the offset to one of blobs touching us by arbitrary index.

Get the offset to one of blobs touching us by blob handle.

Check if this blob is overlapping the given one

Note: this won't work if a blob has recently spawned into a position that would overlap you.

Check if this blob is overlapping one with a given name

Note: this won't work if a blob has recently spawned into a position that would overlap you.

Gets a list of all blobs that are overlapping this blob

Check if this blob can collide with a given blob.

Note: this is the check used internally to determine if two blobs will actually collide.

Get all the attachment points of this blob, into a given array.

Get the number of attachment points of this blob.

CBlob.getAttachmentPoint

Get the attachment point of this blob corresponding to a given arbitrary index.

Attempt to detach from a given blob, must be called serverside.  Sucessful outcomes will be synced to all clients.

Attempt to detach all attached blobs, must be called serverside.  Sucessful outcomes will be synced to all clients.

Attempt to detach from all blobs, must be called serverside.  Sucessful outcomes will be synced to all clients.

Check if this blob is attached to a given one.

Check if this blob is attached to a point with a given name.

Check if this blob is attached to anything.

Check if this blob has anything attached.

Get the absolute position of a given attachment point.

Takes into account rotations, facing left, all that good stuff.

Gets the blob attached to the first "PICKUP" attachment point.

Gets null if there's no "PICKUP" attachment point or no blob attached.

Note: Semi-legacy function, still pretty useful though as all vanilla characters have the needed pickup point and use it for "held" items.

Puts the blob attached to the first "PICKUP" attachment point into this blob's inventory, if possible.

Note: Semi-legacy function, still pretty useful though as all vanilla characters have the needed pickup point and use it for "held" items.

Detaches the blob attached to the first "PICKUP" attachment point.

Note: Semi-legacy function, still pretty useful though as all vanilla characters have the needed pickup point and use it for "held" items.

Attaches the given blob to the first attachment point with a given name.

Must be run on the server, any successful outcomes will be synced to all clients.

Note: Won't give particularly useful behaviour for blobs with multiple attachments of the same name.

Attaches the given blob to the attachment point with the given index.

Must be run on the server, any successful outcomes will be synced to all clients.

Attaches the given blob to the given attachment point.

Must be run on the server, any successful outcomes will be synced to all clients.

Creates the round in-game functionality button.

Clears all menus that are open, grids and bubbles.

Must be run on the client, make sure to only call it for the owner player or you'll clear everyone's menus :)

Clears all grid menus that are open except for the inventory grid.

Must be run on the client, make sure to only call it for the owner player or you'll clear everyone's menus :)

Clears all grid menus that are open.

Must be run on the client, make sure to only call it for the owner player or you'll clear everyone's menus :)

Clears all button menus that are open.

Must be run on the client, make sure to only call it for the owner player or you'll clear everyone's menus :)

Shows the button menu for this object.

Must be run on the client, make sure to only call it for the owner player or you'll open menus for everyone :)

Click any interaction button that's highlighted on the client.

Click the interaction button closest to the given position.

Create the inventory menu for this blob at a given screen position.

Show the pickup buttons for this object.

Show the emoticon menu.

Hide the emoticon menu.

Add a bubble to the emoticon menu, with a description.

Clear the list of bubbles for the emoticon menu.

Load an image for the bubble/emoticon menu.

Set up the minimap vars for this object.

Should usually be done in oninit, though you can change things as the game progresses for things like !!! on the minimap.

Set up the minimap edge behaviour.

Should usually be done in oninit.

Set up if we should always render this on the minimap, even if its in the dark and an enemy.

Should usually be done in oninit.

Unset all the minimap vars, so this renders nothing on the minimap again.

Set the map edge collision flags.

Use a bitfield of CBlob.EdgeEnum values.

Get the currently set map edge collision flags.

Retrieves the sprite component if present.

Retrieves the shape component if present.

Retrieves the movement component if present.

Retrieves the brain component for AI if present.

Retrieves the attachments component if present.

Retrieves the inventory component if present.

Picks up another blob and puts it in the 'PICKUP' attachment slot

Gets the unique ID number of the blob

Returns the blobs team number

Sets the blob team number (server-side and synced to clients).

Gets the head index of the blob.

Sets the head index of the blob.

Gets the sex of the blob (0/1 male/female).

Sets the sex of the blob  (0/1 male/female).

Gets the blob class name

Is this blob controlled by my player? (local player)

int

Is this blob controlled by a bot?

Gets the blob input system.

Returns the .cfg config file name from which this blob was loaded from

Is the blob currently having this key pressed?

Was this key pressed in the previous tick?

bool -true or false

Was this key pressed this tick?

bool -true or false

Was this key released in this tick?

bool -true or false

Sets the blobs key.

Get the blob's aim/mouse position.

Set the blob's aim/mouse position.

Note that this won't actually move the mouse for player controlled blobs - it's intended for use in bots, remote controlled items, animals, etc.

Get the blob's aim/mouse direction (and optionally the aim vector as well).

Disable (or enable) specific keys for this blob.

Disable (or enable) the mouse for this blob.

Check if we would be overlapped if we moved to a given position, at a given angle.

Kinda buggy as is.

Get the distance to a given other blob.

Very likely faster than doing it yourself.

Hit another blob.

Hit another blob.

Hit the tilemap.

Do damage to this blob, setting who hit us last in the process.

Only use this in a blob's onHit function!

Heal this blob by some amount, up to a maximum of its original (configfile) health.

Set this blob's health absolutely.

Set the player that owns the damage from this blob.

Useful for things like bombs/arrows, anything they hit will act as though hit by their owner.

Get the player that owns the damage from this blob.

Set the player that most recently hit this blob.

Get the player that most recently hit this blob.

Gets a list of all players that have dealt damage to this blob

Gets a list of all the times when the blob was damaged

Gets a list of the hearts of damage done to the blob on each hit

Set a blob to ignore collisions with until we stop overlapping.

Set a blob to ignore collisions with until we stop overlapping or some ticks run out.

Plug a player into this blob, or remove the currently plugged player.

Move this blob's inventory to some other blob's (normally done just before killing the blob).

Get the player plugged into this blob.

Set the time before this blob mysteriously vanishes.  The timer stops if blob is in an inventory.

This is generally done for bodies, materials etc; the blob dying by this method doesn't invoke any hits/effects.

If you want effects when it happens you need to do so in onDie (similarly with CBlob.server_Die)

Set a negative time to disable the kill countdown.

Get the time in ticks before this blob mysteriously vanishes.

Get the time in seconds before this blob mysteriously vanishes.

Get an existing command ID from a string.

Adds the ID if it doesn't already exist, but prints a warning. It's best to add the command id in onInit.

Add a command ID from a string.

Checks if command ID exists

Get the name of an existing command ID.

Essentially the reverse of CBlob.getCommandID

Set the light radius of this blob.

Set the light color of this blob.

Set the light on or off.

Check if the light is on or off.

Get the light radius.

Get the light color.

Check if the blob is on screen or not.

Check if the blob is in fire or not.

Check if the blob is flammable.

This is really just to check the variable from config file - the engine doesn't do anything special with flammable blobs.

Check how long this blob has existed for.

Make this blob say a chat bubble.

Useful for bots/npcs.

Sets the chat font.

Max number of lines in chat bubble

Sets the chat font.

Is the chat bubble visible?

Get the map that contains this blob.

For now (and probably forever) this is the same as the global <getMap()>

Returns true if the blob has the passed quantity of blobs in its inventory

Removes the passed quantity of blobs from inventory

Quantity of blobs inside of this blobs inventory

Creates a new blob in the world.

Creates a new blob in the world.

Creates a new blob in the world but doesn't initialize it. Useful if you need to pass parameters to the onInit() function. Call blob.init() when you're ready.