mirror of
https://github.com/kuitoi/kuitoi-Server.git
synced 2025-07-02 15:55:29 +00:00
[+] Basic events
[~] Remove double texts
This commit is contained in:
parent
274bdead2f
commit
c838d42dd8
@ -1,3 +1,13 @@
|
|||||||
# 所有可用事件列表
|
# 所有可用事件列表
|
||||||
|
|
||||||
大多数事件将包含`pl = data ['kwargs'] ['player']`,可以在[这里](./classes.md)找到描述。
|
大多数事件将包含`pl = data ['kwargs'] ['player']`,可以在[这里](./classes.md)找到描述。
|
||||||
|
|
||||||
|
* onPlayerJoin
|
||||||
|
* onPlayerDisconnect
|
||||||
|
* playerLoaded
|
||||||
|
* onChatReceive
|
||||||
|
* onCarSpawn
|
||||||
|
* onCarDelete
|
||||||
|
* onCarEdited
|
||||||
|
* onCarChanged
|
||||||
|
* ...
|
||||||
|
@ -1,127 +1,3 @@
|
|||||||
Sure, here's a translation of the text:
|
|
||||||
|
|
||||||
# Passed Classes
|
|
||||||
|
|
||||||
## Worth looking at
|
|
||||||
|
|
||||||
1. What are `*args` and `**kwargs`? -> [Post on Habr (RU)](https://habr.com/ru/companies/ruvds/articles/482464/)
|
|
||||||
|
|
||||||
## KuiToi
|
|
||||||
_`kt = KuiToi("PluginName"")`_
|
|
||||||
|
|
||||||
### kt.log
|
|
||||||
_Constant_\
|
|
||||||
Returns a pre-configured logger
|
|
||||||
|
|
||||||
### kt.name
|
|
||||||
_Constant_\
|
|
||||||
Returns the name of the plugin
|
|
||||||
|
|
||||||
### kt.dir
|
|
||||||
_Constant_\
|
|
||||||
Returns the directory of the plugin
|
|
||||||
|
|
||||||
### kt.open()
|
|
||||||
_Parameters are the same as for open()_\
|
|
||||||
Opens a file in kt.dir
|
|
||||||
|
|
||||||
### kt.register_event(event_name: str, event_func: function)
|
|
||||||
_`event_name: str` -> The name of the event that `event_func` will be called on._\
|
|
||||||
_`event_func: function` -> The function that will be called._
|
|
||||||
|
|
||||||
In `event_func`, you can pass both regular functions and async functions - you don't need to make them async beforehand.\
|
|
||||||
You can also create your own events with your own names.\
|
|
||||||
You can register an unlimited number of events.
|
|
||||||
|
|
||||||
### kt.call_event(event_name: str, *args, **kwargs) -> list:
|
|
||||||
_`event_name: str` -> The name of the event to call._\
|
|
||||||
_`*args, **kwargs` -> Arguments to be passed to the function._
|
|
||||||
|
|
||||||
### **async** kt.call_async_event(event_name: str, *args, **kwargs) -> list:
|
|
||||||
_`event_name: str` -> The name of the event to call._\
|
|
||||||
_`*args, **kwargs` -> Arguments to be passed to the function._\
|
|
||||||
_Must be called with `await`_
|
|
||||||
|
|
||||||
###### _I recommend familiarizing yourself with *args, **kwargs_, there is a link at the beginning
|
|
||||||
Data is passed to all events in the form of: `{"event_name": event_name, "args": args, "kwargs": kwargs}`\
|
|
||||||
`args: list` -> Represents an array of data passed to the event\
|
|
||||||
`kwargs: dict` -> Represents a dictionary of data passed to the event
|
|
||||||
The data will be returned from all successful attempts in an array.
|
|
||||||
|
|
||||||
### kt.call_lua_event(event_name: str, *args) -> list:
|
|
||||||
_`event_name: str` -> The name of the event to call._\
|
|
||||||
_`*args` -> Arguments to be passed to the function._
|
|
||||||
|
|
||||||
Added to support backward compatibility.\
|
|
||||||
The lua function is called with a direct transmission of arguments `lua_func(*args)`
|
|
||||||
|
|
||||||
### kt.get_player([pid: int], [nick: str]) -> Player | None:
|
|
||||||
_`pid: int` -> Player ID - The identifier of the player._\
|
|
||||||
_`nick: str` -> Player Nickname - The name of the player._
|
|
||||||
|
|
||||||
The method returns a player object by their `pid` or `nick`.\
|
|
||||||
If the player cannot be found, `None` will be returned.
|
|
||||||
|
|
||||||
### kt.get_players() -> List[Player] | list:
|
|
||||||
|
|
||||||
The method returns an array with all players.\
|
|
||||||
The array will be empty if there are no players.
|
|
||||||
|
|
||||||
### kt.players_counter() -> int:
|
|
||||||
|
|
||||||
The method returns the number of players currently online.
|
|
||||||
|
|
||||||
### kt.is_player_connected([pid: int], [nick: str]) -> bool:
|
|
||||||
_`pid: int` -> Player ID - The identifier of the player._\
|
|
||||||
_`nick: str` -> Player Nickname - The name of the player._
|
|
||||||
|
|
||||||
The method returns a player object by their `pid` or `nick`.
|
|
||||||
|
|
||||||
## Player (or Client)
|
|
||||||
_`pl = kt.get_player()`_\
|
|
||||||
_`pl = event_data['kwargs']['player']`_
|
|
||||||
|
|
||||||
### pl.log -> Logger
|
|
||||||
_Constant_\
|
|
||||||
Returns a pre-configured logger
|
|
||||||
|
|
||||||
### pl.addr -> str
|
|
||||||
_Constant_\
|
|
||||||
Returns the IP address of the player
|
|
||||||
|
|
||||||
### pl.pid -> int
|
|
||||||
### pl.cid -> int
|
|
||||||
_Constant_\
|
|
||||||
Returns the client ID _(pid: PlayerId = cid: ClientId)_
|
|
||||||
|
|
||||||
### pl.key -> str
|
|
||||||
_Constant_\
|
|
||||||
Returns the key passed during authentication
|
|
||||||
|
|
||||||
### pl.nick -> str
|
|
||||||
_Variable_\
|
|
||||||
The nickname passed during authentication from the BeamMP server, can be changed, consequences are untested
|
|
||||||
|
|
||||||
### pl.roles -> str
|
|
||||||
_Variable_\
|
|
||||||
The role passed during authentication from the BeamMP server, can be changed (if an incorrect role is set, unexpected things may happen.)
|
|
||||||
|
|
||||||
### pl.guest -> bool
|
|
||||||
_Constant_\
|
|
||||||
Returns whether the player is a guest, passed during authentication from the BeamMP server
|
|
||||||
|
|
||||||
### pl.identifiers -> dict
|
|
||||||
_Constant_\
|
|
||||||
Identifiers passed during authentication from the BeamMP server.
|
|
||||||
|
|
||||||
### pl.ready -> bool
|
|
||||||
_Constant, changed by the core_\
|
|
||||||
Returns a bool value, if True -> the player has downloaded all resources, loaded on the map
|
|
||||||
|
|
||||||
### pl.cars -> dict
|
|
||||||
_Constant, changed by the core_\
|
|
||||||
Returns a dictionary of cars like thisSure, here's the translation:
|
|
||||||
|
|
||||||
# Passed Classes
|
# Passed Classes
|
||||||
|
|
||||||
## Worth looking at
|
## Worth looking at
|
||||||
|
@ -2,3 +2,12 @@
|
|||||||
|
|
||||||
Most events will receive `pl = data['kwargs']['player']`, you can find a description [here](./classes.md)
|
Most events will receive `pl = data['kwargs']['player']`, you can find a description [here](./classes.md)
|
||||||
|
|
||||||
|
* onPlayerJoin
|
||||||
|
* onPlayerDisconnect
|
||||||
|
* playerLoaded
|
||||||
|
* onChatReceive
|
||||||
|
* onCarSpawn
|
||||||
|
* onCarDelete
|
||||||
|
* onCarEdited
|
||||||
|
* onCarChanged
|
||||||
|
* ...
|
@ -2,4 +2,12 @@
|
|||||||
|
|
||||||
В большинство ивентов будет приходить `pl = data['kwargs']['player']`, описание можно найти [тут](./classes.md)
|
В большинство ивентов будет приходить `pl = data['kwargs']['player']`, описание можно найти [тут](./classes.md)
|
||||||
|
|
||||||
###
|
* onPlayerJoin
|
||||||
|
* onPlayerDisconnect
|
||||||
|
* playerLoaded
|
||||||
|
* onChatReceive
|
||||||
|
* onCarSpawn
|
||||||
|
* onCarDelete
|
||||||
|
* onCarEdited
|
||||||
|
* onCarChanged
|
||||||
|
* ...
|
Loading…
x
Reference in New Issue
Block a user