techages/mods/ITEMS/mcl_throwing/API.md

1.4 KiB

mcl_throwing

mcl_throwing.throw(throw_item, pos, dir, velocity, thrower)

Throw a throwable item.

  • throw_item: itemstring of the throwable item
  • pos: initial position of the entity
  • dir: direction where the throwable item will be thrown
  • velocity: (optional) will overide the default velocity value (can be nil)
  • thrower: (optional) player/entity who throw the object (can be nil)

mcl_throwing.register_throwable_object(name, entity, velocity)

Register a throwable item.

  • name: itemname of the throwable object
  • entity: entity thrown
  • velocity: initial velocity of the entity

mcl_throwing.dispense_function(stack, dispenserpos, droppos, dropnode, dropdir)

Throw throwable item from dispencer.

Shouldn't be called directly.

Must be used in item definition:

_on_dispense = mcl_throwing.dispense_function,

mcl_throwing.get_player_throw_function(entity_name, velocity)

Return a function who handle item throwing (to be used in item definition)

Handle creative mode, and throw params.

  • entity_name: the name of the entity to throw
  • velocity: (optional) velocity overide (can be nil)

mcl_throwing.get_staticdata(self)

Must be used in entity def if you want the entity to be saved after unloading mapblock.

mcl_throwing.on_activate(self, staticdata, dtime_s)

Must be used in entity def if you want the entity to be saved after unloading mapblock.