docs: Added onPlayerDropItem and onPlayerTakeItem events
This commit is contained in:
19
docs/defaultEvents/player/onPlayerDropItem.md
Normal file
19
docs/defaultEvents/player/onPlayerDropItem.md
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
# `event` onPlayerDropItem
|
||||||
|
This event is triggered when player drops an item from his inventory to the ground.
|
||||||
|
|
||||||
|
Original: [onPlayerDropItem](https://gothicmultiplayerteam.gitlab.io/docs/0.3.0/script-reference/server-events/player/onPlayerDropItem/)
|
||||||
|
|
||||||
|
## Parameters
|
||||||
|
* `dict` **kwargs**:
|
||||||
|
* `int` **playerid**: the id of the player who tries to drop the item on the ground.
|
||||||
|
* `ItemGround` **itemGround**: the ground item object which represents the dropped item by the player.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
```python
|
||||||
|
import g2o
|
||||||
|
|
||||||
|
@g2o.event('onPlayerDropItem')
|
||||||
|
def onDropItem(**kwargs):
|
||||||
|
item = itemm['itemGround']
|
||||||
|
print(f'Player {kwargs['playerid']} dropped {item.instance} x{item.amount}')
|
||||||
|
```
|
||||||
22
docs/defaultEvents/player/onPlayerTakeItem.md
Normal file
22
docs/defaultEvents/player/onPlayerTakeItem.md
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
# `event` onPlayerTakeItem
|
||||||
|
!!! note
|
||||||
|
Even if this event is triggered it doesn't mean, that player will get item to his inventory. It only means, that the player tried to get the item from the ground. Server is the last decide if the item can be taken from the ground. Canceling this event will prevent the item to be taken from the ground.
|
||||||
|
|
||||||
|
This event is triggered when player takes an item from the ground.
|
||||||
|
|
||||||
|
Original: [onPlayerTakeItem](https://gothicmultiplayerteam.gitlab.io/docs/0.3.0/script-reference/server-events/player/onPlayerTakeItem/)
|
||||||
|
|
||||||
|
## Parameters
|
||||||
|
* `dict` **kwargs**:
|
||||||
|
* `int` **playerid**: the id of the player who tries to take the ground item.
|
||||||
|
* `ItemGround` **itemGround**: the ground item object which player tried to to take.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
```python
|
||||||
|
import g2o
|
||||||
|
|
||||||
|
@g2o.event('onPlayerTakeItem')
|
||||||
|
def onTakeItem(**kwargs):
|
||||||
|
item = itemm['itemGround']
|
||||||
|
print(f'Player {kwargs['playerid']} took {item.instance} x{item.amount}')
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user