summaryrefslogtreecommitdiff
path: root/doc/lua_api.txt
Commit message (Collapse)AuthorAge
* Simple deco: Allow setting param2 value on placementAuke Kok2016-12-07
| | | | | | | | | | | | | Schematics can already be placed with a param2 value, but not simple 1-node plant decorations of the simple type. This adds a `param2` field to the simple deco type that is checked to be between 0 and 255, and put to the placed node at mapgen. This can be used to put a degrotate value in, or e.g. a fill value for leveltype nodes, or a place_param2 value at mapgen placement, or vary the shape of meshoptions plantlike drawtype.
* Fix incorrect docs about minetest.hud_replace_builtin (#4833)Amaz2016-12-02
| | | Fixes https://github.com/minetest/minetest/issues/4832
* Very small documentation fix. (#4830)Bluebird2016-12-02
|
* Lua_api.txt: Clarify use of looping soundsparamat2016-12-01
|
* Allow restricting detached inventories to one playersfan52016-11-28
| | | | | | | This combats the problem of sending the hundreds of "creative" / "armor" or whatever detached invs that exist on popular servers to each and every player on join or on change of said invs.
* Wieldhand: Allow overriding the handTeTpaAka2016-11-26
|
* Make supplying empty formspec strings close the formspec (#4737)orwell962016-11-23
| | | This will only happen if the formname matches or if formname is "".
* Particles: Make attached particle spawners respect the parent's yaworwell962016-11-18
| | | | | | Position, velocity and acceleration vectors of particles are rotated by the yaw of the parent object so that they are truly relative to it. Clarify new attached particle spawner behavior in lua_api.txt.
* Builtin/../item: Enable tool breaking soundsAuke Kok2016-11-18
| | | | | | | | | | If a tool wears out and is destroyed, it's itemstack count goes to 0, and we can optionally play a breaking sound. This patch implements playing a breaking sound when this occurs. Sounds need to be added to the tool itemdef registration as the sound name string in the .sound.breaks member.
* Lua_api.txt: Naming convention for custom item/entity fieldsWuzzy2016-11-15
| | | | | | | Custom (non-engine) field names of items and entities are allowed. This is now documented in lua_api.txt. Field names beginning with an underscore are now reserved for mod use, the engine must not introduce any fields beginning with an underscore.
* Revert "Adding particle blend, glow and animation (#4705)"sfan52016-11-14
| | | | This reverts commit 93e3555eae2deaeca69ee252cfa9cc9c3e0e49ef.
* Adding particle blend, glow and animation (#4705)Foghrye42016-11-15
|
* Rename nodeupdate and nodeupdate_single and make them part of the official APIest312016-11-14
| | | | | | | | | | | | | | | Now, the renamed forms of nodeupdate and nodeupdate_single are part of the official API. As nodeupdate has been used by Minetest Game and in mods despite of not being part of the official API, we ease the transition by still supporting it for the 0.4.15 release. After the release, the two functions can be removed. The removal will not violate the stability promise, as that promise only includes the official and documented API. Also, make some formerly global functions local. They most likely haven't been used by mods, therefore they won't get stubs with deprecation warnings, hard erroring directly.
* Nodeupdate: Remove documentation in lua_api.txtparamat2016-11-12
| | | | | In preparation for nodeupdate being renamed and made official API in future.
* Add minetest.get_server_uptime() function to Lua API (#4702)Brandon2016-11-02
| | | Add minetest.get_server_uptime() function to Lua API
* Add version APIShadowNinja2016-10-31
|
* Lua voxelmanip: Add optional buffer param for 'get param2 data'paramat2016-10-31
| | | | Update lua_api.txt.
* Document item use callbacks (#4668)raymoo2016-10-27
|
* Lua_api.txt: Clarify 'override_meta' bool in 'set mapgen setting'paramat2016-10-21
|
* Builtin: Add vector.floor helper functionrubenwardy2016-10-17
|
* Make documentation about ItemStack:set_{name,count,wear} clearersfan52016-10-15
| | | | | These methods do not actually fail but instead clear the item stack and return false if a value like e.g. "" is passed.
* Attached particle spawnersraymoo2016-10-13
|
* Fix backwards compatibility issue introduced by close_on_enterrubenwardy2016-10-08
|
* Lua_api.txt: Add biome and nodeupdate documentationparamat2016-10-08
| | | | | | | Add missing documentation for 'register_biome' and 'clear_registered_biomes'. Add documentation for 'nodeupdate_single'. 'nodeupdate' is not yet documented due to a bug it causes.
* Forceloading: Transient forceloadsraymoo2016-10-03
| | | | | Adds a flag to forceload_block which lets you turn off persistence for that forceload.
* Formspec: Add container[] and container_end[] elementsrubenwardy2016-10-03
|
* Register.lua: Throw error if node 'light_source' > core.LIGHT_MAXparamat2016-09-17
| | | | | | | | Add 'core.LIGHT_MAX = 14' to builtin/game/constants.lua with the intention to replace misplaced 'default.LIGHT_MAX = 14' in Minetest Game. Add comment in light.h requiring the constant be changed in both places. Add lighting bug warning to note in lua_api.txt. There are hundreds of mod uses of 15 which causes a lighting bug.
* Lua_api.txt: Add note of maximum value for node 'light_source'paramat2016-09-15
| | | | | Maximum is 14. A value of 15 (reserved for direct sunlight) causes a lighting bug.
* Add an [invert:<mode> texture modifierThomas--S2016-09-15
| | | | | | Inverts the given channels of the base image. Mode may contain the characters "r", "g", "b", "a". Only the channels that are mentioned in the mode string will be inverted.
* Decorations: Generalise 'spawn by' to be used by all decoration typesparamat2016-09-14
| | | | In lua_api.txt, make clear that 'place on' and 'spawn by' can be lists.
* Allow escaping of texture names when passed as an argument to a modifiersfan52016-09-14
|
* fix missing parameters in some mentions of entity callbacksraymoo2016-09-12
|
* Return nil on empty get_area() (#4508)James Stevenson2016-09-10
|
* Add minetest.unregister_item and minetest.register_alias_forcepaly22016-09-08
|
* Allow fields to choose whether they close on enter pressrubenwardy2016-08-27
|
* Make plantlike drawtype more funAuke Kok2016-08-26
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Adds several new ways that the plantlike drawtype mesh can be changed. This requires paramtype2 = "meshoptions" to be set in the node definition. The drawtype for these nodes should be "plantlike". These modifications are all done using param2. This field is now a complex bitfield that allows some or more of the combinations to be chosen, and the mesh draw code will choose the options based as neeeded for each plantlike node. bit layout: bits 0, 1 and 2 (values 0x1 through 0x7) are for choosing the plant mesh shape: 0 - ordinary plantlike plant ("x" shaped) 1 - ordinary plant, but rotated 45 degrees ("+" shaped) 2 - a plant with 3 faces ("*" shaped) 3 - a plant with 4 faces ("#" shaped) 4 - a plant with 4 faces ("#" shaped, leaning outwards) 5 through 7 are unused and reserved for future mesh shapes. bit 3 (0x8) causes the plant to be randomly offset in the x,z plane. The plant should fall within the 1x1x1 nodebox if regularly sized. bit 4 (0x10) causes the plant mesh to grow by sqrt(2), and will cause the plant mesh to fill out 1x1x1, and appear slightly larger. Texture makers will want to make their plant texture 23x16 pixels to have the best visual fit in 1x1x1 size. bit 5 (0x20) causes each face of the plant to have a slight negative Y offset in position, descending up to 0.125 downwards into the node below. Because this is per face, this causes the plant model to be less symmetric. bit 6 (0x40) through bit 7 (0x80) are unused and reserved for future use. !(https://youtu.be/qWuI664krsI)
* Lua_api.txt: Change 'maxwear' to 'uses' in 'tool_capabilities'DonBatman2016-08-14
| | | | | 'maxwear' has been deprecated for over 3 years Add spaces around '=' nearby
* Add an [opacity:<r> texture modifier. Makes the base image transparent ↵Thomas--S2016-08-12
| | | | according to the given ratio. r must be between 0 and 255. 0 means totally transparent. 255 means totally opaque. Useful for texture overlaying.
* Documentation: Create texture_packs.txtrubenwardy2016-07-30
| | | | Combine texture_overrides.txt and sections of lua_api.txt
* lua_api.txt: Document how to properly clear node metadatamtango6882016-07-30
|
* Main menu, lua_api.txt: Fix mod/texture pack screenshot size issuesWuzzy2016-07-27
| | | | | | Recommend mod screenshot size in lua_api.txt Adjust displayed screenshot size of texture packs Document texture pack files in lua_api.txt
* lua_api.txt: Remove tooltip checkbox[] elementJames Stevenson2016-07-21
|
* HTTP lua API docs: correct some function referencesest312016-07-12
|
* Builtin/profiler: Replace game profiler (#4245)Tim2016-07-12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Use the setting "profiler.load" to enable profiling. Other settings can be found in settingtypes.txt. * /profiler print [filter] - report statistics to in-game console * /profiler dump [filter] - report statistics to STDOUT and debug.txt * /profiler save [format [filter]] - saves statistics to a file in your worldpath * txt (default) - same treetable format as used by the dump and print commands * csv - ready for spreadsheet import * json - useful for adhoc D3 visualizations * json_pretty - line wrapped and intended json for humans * lua - serialized lua table of the profile-data, for adhoc scripts * /profiler reset - reset all gathered profile data. This can be helpful to discard of any startup measurements that often spike during loading or to get more useful min-values. [filter] allows limiting the output of the data via substring/pattern matching against the modname. Note: Serialized data structures might be subject to change with changed or added measurements. csv might be the most stable, due to flat structure. Changes to the previous version include: * Updated and extended API monitoring * Correct calculation of average (mean) values (undistorted by idleness) * Reduce instrumentation overhead. * Fix crashes related to missing parameters for the future and occasional DIV/0's. * Prevent issues caused by timetravel (overflow, timejump, NTP corrections) * Prevent modname clashes with internal names. * Measure each instrumentation individually and label based on registration order. * Labeling of ABM's and LBM's for easier classification. Giving several ABM's or LBM's the same label will treat them as one. Missing labels will be autogenerated based on name or registration order. * Configurable instrumentation and reporting. Skip e.g. builtin if you don't need it. * Profile the profiler to measure instrumentation overhead.
* Lua_api.txt: Fix description of node drop behaviourDuane2016-07-12
|
* Adding minetest.clear_craftFoghrye42016-07-05
| | | | | Modifications by est31: grammar fixes in doc + error messages and a little style fix, no functional change.
* Add MapSettingsManager and new mapgen setting script API functionskwolekr2016-07-03
| | | | | | | | | | | | | | | This commit refactors the majority of the Mapgen settings system. - MapgenParams is now owned by MapSettingsManager, itself a part of ServerMap, instead of the EmergeManager. - New Script API functions added: core.get_mapgen_setting core.get_mapgen_setting_noiseparams, core.set_mapgen_setting, and core.set_mapgen_setting_noiseparams. - minetest.get/set_mapgen_params are deprecated by the above new functions. - It is now possible to view and modify any arbitrary mapgen setting from a mod, rather than the base MapgenParams structure. - MapgenSpecificParams has been removed.
* Player: New get_look, set_look APIraymoo2016-06-24
| | | | Deprecate get_look / set_look pitch / yaw
* Builtin/game/item: Add `place_param2` nodedef fieldAuke Kok2016-06-17
| | | | | | | | | | | | | | | This allows a nodedef to specify a fixed value for param2 to be used for all normal placements. There are several uses for this: - nodes that require param2 to be set to a non-zero value for internal mod use. E.g. leafdecay could use this to detect that leaves are played by players. - force wallmounted or facedir value at placement at placement This overrides any player look direction or other on-the-fly param2 setting during placement.
* Server: Add reason for leave to `on_leaveplayer` callbacksDiego Martinez2016-06-11
|