docs: Added docs for toggleEvent and removeEvent functions
This commit is contained in:
@@ -1,3 +1,3 @@
|
|||||||
# `class` ItemGround
|
# `static class` ItemGround
|
||||||
---
|
---
|
||||||
::: g2o.classes.items.ItemGround
|
::: g2o.classes.items.ItemGround
|
||||||
@@ -42,10 +42,12 @@ def evtTake(**kwargs):
|
|||||||
return False
|
return False
|
||||||
```
|
```
|
||||||
---
|
---
|
||||||
* `isEventCancelled` replaced with built-in function property `cancelled`, alongside with the `eventName` (if you need it for some reason)
|
* `isEventCancelled` replaced with built-in function property `cancelled`, alongside with the `eventName`
|
||||||
```python
|
```python
|
||||||
@g2o.event('onPlayerDropItem')
|
@g2o.event('onPlayerDropItem')
|
||||||
def evtDrop(**kwargs):
|
def evtDrop(**kwargs):
|
||||||
print(evtDrop.cancelled)
|
print(evtDrop.cancelled)
|
||||||
print(evtDrop.eventName)
|
print(evtDrop.eventName)
|
||||||
```
|
```
|
||||||
|
---
|
||||||
|
* `eventValue` has been removed (RIP)
|
||||||
2
docs/events/removeEvent.md
Normal file
2
docs/events/removeEvent.md
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
# `function` removeEvent
|
||||||
|
::: g2o.events.removeEvent
|
||||||
2
docs/events/toggleEvent.md
Normal file
2
docs/events/toggleEvent.md
Normal file
@@ -0,0 +1,2 @@
|
|||||||
|
# `function` toggleEvent
|
||||||
|
::: g2o.events.toggleEvent
|
||||||
@@ -132,12 +132,62 @@ def removeEventHandler(name : str, func : object):
|
|||||||
del eventList[name][index]
|
del eventList[name][index]
|
||||||
|
|
||||||
def toggleEvent(name : str, toggle : bool):
|
def toggleEvent(name : str, toggle : bool):
|
||||||
|
'''
|
||||||
|
!!! note
|
||||||
|
By default every event is toggled `on` (enabled).
|
||||||
|
|
||||||
|
This function will toggle event (enable or disable it globally). By toggling event off, you can completely disable certain event from calling it's handlers.
|
||||||
|
Original: [toggleEvent](https://gothicmultiplayerteam.gitlab.io/docs/0.3.0/script-reference/shared-functions/event/toggleEvent/)
|
||||||
|
|
||||||
|
## Declaration
|
||||||
|
```python
|
||||||
|
def toggleEvent(name : str, toggle : bool)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Parameters
|
||||||
|
* `str` **name**: the name of the event
|
||||||
|
* `bool` **toggle**: `false` if you want to disable the event, otherwise true.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
```python
|
||||||
|
import g2o
|
||||||
|
|
||||||
|
@g2o.event('onTime')
|
||||||
|
def onTimeEvt(**kwargs):
|
||||||
|
print('Calling only once')
|
||||||
|
g2o.toggleEvent('onTime', false)
|
||||||
|
```
|
||||||
|
'''
|
||||||
if not toggle and name not in disabledEventList:
|
if not toggle and name not in disabledEventList:
|
||||||
disabledEventList.append(name)
|
disabledEventList.append(name)
|
||||||
elif toggle and name in disabledEventList:
|
elif toggle and name in disabledEventList:
|
||||||
disabledEventList.remove(name)
|
disabledEventList.remove(name)
|
||||||
|
|
||||||
def removeEvent(name : str):
|
def removeEvent(name : str):
|
||||||
|
'''
|
||||||
|
!!! warning
|
||||||
|
Removing an event also cause all event handlers to unregister.
|
||||||
|
This function will unregister an event with specified name.
|
||||||
|
Original: [removeEvent](https://gothicmultiplayerteam.gitlab.io/docs/0.3.0/script-reference/shared-functions/event/removeEvent/)
|
||||||
|
|
||||||
|
## Declaration
|
||||||
|
```python
|
||||||
|
def removeEvent(name : str)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Parameters
|
||||||
|
* `str` **name**: the name of the event
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
```python
|
||||||
|
import g2o
|
||||||
|
|
||||||
|
@g2o.event('onTime')
|
||||||
|
def onTimeEvt(**kwargs):
|
||||||
|
print('Calling only once')
|
||||||
|
g2o.removeEvent('onTime')
|
||||||
|
```
|
||||||
|
'''
|
||||||
if name in eventList:
|
if name in eventList:
|
||||||
eventList.pop(name)
|
eventList.pop(name)
|
||||||
|
|
||||||
|
|||||||
@@ -93,11 +93,13 @@ nav:
|
|||||||
- onPlayerTeleport: defaultEvents/player/onPlayerTeleport.md
|
- onPlayerTeleport: defaultEvents/player/onPlayerTeleport.md
|
||||||
- onPlayerToggleFaceAni: defaultEvents/player/onPlayerToggleFaceAni.md
|
- onPlayerToggleFaceAni: defaultEvents/player/onPlayerToggleFaceAni.md
|
||||||
- Functions:
|
- Functions:
|
||||||
- Events:
|
- Events:
|
||||||
- event: events/event.md
|
|
||||||
- removeEventHandler: events/removeEventHandler.md
|
|
||||||
- addEvent: events/addEvent.md
|
- addEvent: events/addEvent.md
|
||||||
|
- event: events/event.md
|
||||||
- callEvent: events/callEvent.md
|
- callEvent: events/callEvent.md
|
||||||
|
- removeEvent: events/removeEvent.md
|
||||||
|
- removeEventHandler: events/removeEventHandler.md
|
||||||
|
- toggleEvent: events/toggleEvent.md
|
||||||
- How to build: howtobuild.md
|
- How to build: howtobuild.md
|
||||||
|
|
||||||
theme:
|
theme:
|
||||||
|
|||||||
Reference in New Issue
Block a user