diff options
author | Lars Müller <34514239+appgurueu@users.noreply.github.com> | 2022-06-11 20:01:14 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-06-11 20:01:14 +0200 |
commit | e7d4ec6834282402c24fe432e0dcebe78b7fcd01 (patch) | |
tree | 5ccd0bb17b5eba3dc48b8954c07c296c6a64437d /doc | |
parent | f4a53f7ee6fb5482f8193353c35be54b40533d6f (diff) | |
download | minetest-e7d4ec6834282402c24fe432e0dcebe78b7fcd01.tar.gz minetest-e7d4ec6834282402c24fe432e0dcebe78b7fcd01.tar.bz2 minetest-e7d4ec6834282402c24fe432e0dcebe78b7fcd01.zip |
on_deactivate: distinguish removal and unloading (#11931)
Sometimes you need to be able to do removal-related cleanup, such as removing files from disk, or entries from a database. staticdata obviously isn't suitable for large data. The data shouldn't be removed if the entity is unloaded, only if it is removed.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/lua_api.txt | 8 |
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/lua_api.txt b/doc/lua_api.txt index 7744b02bf..a41a5217e 100644 --- a/doc/lua_api.txt +++ b/doc/lua_api.txt @@ -4551,8 +4551,14 @@ Callbacks: * Called when the object is instantiated. * `dtime_s` is the time passed since the object was unloaded, which can be used for updating the entity state. -* `on_deactivate(self) +* `on_deactivate(self, removal) * Called when the object is about to get removed or unloaded. + * `removal`: boolean indicating whether the object is about to get removed. + Calling `object:remove()` on an active object will call this with `removal=true`. + The mapblock the entity resides in being unloaded will call this with `removal=false`. + * Note that this won't be called if the object hasn't been activated in the first place. + In particular, `minetest.clear_objects({mode = "full"})` won't call this, + whereas `minetest.clear_objects({mode = "quick"})` might call this. * `on_step(self, dtime)` * Called on every server tick, after movement and collision processing. `dtime` is usually 0.1 seconds, as per the `dedicated_server_step` setting |