Minetest is an open source voxel game engine with easy modding and game creation
Go to file
HybridDog cda112493a
Faster blit_with_alpha() (#14448)
* Add test nodes for alpha compositing and the fill texture modifier

Texture test nodes can be helpful to test if `blit_with_alpha` works correctly.

The alpha compositing test node covers different cases where pixel colors are mixed with each other.
The test currently fails because `blitPixel` does not work correctly if a semi-transparent color
is drawn on top of another semi-transparent color.
The test nodes for the fill texture modifier show if the size and position arguments of the modifier work correctly.
They do not cover special cases such as very large or negative position or size values.

* Faster blit_with_alpha()

The `blit_with_alpha` function has a noticeable effect on the time it takes to join a game.

To reduce the join times, I replace the `blit_with_alpha` function with a new one:
* It does not uses floating-point numbers.
* It directly operates on the raw pixel data instead of using the comparatively
  slow `setPixel` and `getPixel` functions from Irrlicht.
  Only ECF_A8R8G8B8 base images are supported now.
  If the top image does not have the ECF_A8R8G8B8 color format, it is converted;
  I assume that this happens rarely.
* There are case distinctions for fully opaque, fully transparent and semi-transparent pixels.
  This empirically increases the performance since the mixing between two semi-transparent happens rarely.
* The new function no longer has the `src_pos` argument since it was always the zero vector.
* The function is only documented once where it is declared.

For backwards compatibility, `blit_with_alpha` still mixes colors without gamma correction.
`blit_with_alpha` nonetheless behaves slightly different than before:
If a semi-transparent pixel is drawn on top of another semi-transparent pixel,
the color is mixed in a way which we can consider to be more correct now.
2024-03-19 19:56:47 +01:00
.github Fix multiplayer test missing crashes at shutdown 2024-03-17 15:55:24 +01:00
android Update NDK 2024-03-09 11:28:12 +01:00
builtin Item meta pointing range (#14347) 2024-03-17 15:55:38 +01:00
client VBO-related optimizations and improvements (#14395) 2024-02-29 17:20:57 +01:00
clientmods/preview Rename hud_elem_type to type (#14065) 2023-12-29 21:51:02 +01:00
cmake/Modules Android build via CMake (#13528) 2023-05-26 15:21:23 +02:00
doc Item meta pointing range (#14347) 2024-03-17 15:55:38 +01:00
fonts Fully remove bitmap font support (#11863) 2022-01-08 14:53:25 +01:00
games/devtest Faster blit_with_alpha() (#14448) 2024-03-19 19:56:47 +01:00
lib Update Lua BitOp's stdint.h check for MSVC 2024-03-19 19:54:57 +01:00
misc Use newer IrrlichtMt 2024-02-26 20:47:47 +01:00
mods Remove trailing whitespace (#13505) 2023-05-18 20:34:18 +02:00
po Run updatepo.sh 2023-12-03 18:48:54 +01:00
src Faster blit_with_alpha() (#14448) 2024-03-19 19:56:47 +01:00
textures Add package update detection on Content tab (#13807) 2023-10-28 17:33:44 +01:00
util Fix multiplayer test missing crashes at shutdown 2024-03-17 15:55:24 +01:00
worlds Add a worlds_here.txt file in the worlds folder and update .gitignore (#12720) 2022-10-30 16:53:31 +01:00
.clang-tidy Update clang-tidy configuration and scripts 2020-03-12 00:10:09 +01:00
.dockerignore fix: don't send the whole local context to the docker image 2021-04-02 14:40:22 +02:00
.editorconfig Remove mistaken exec mode from three files 2024-01-17 20:06:26 +01:00
.gitattributes .gitattributes 2011-08-11 17:57:40 +02:00
.gitignore Allow dynamic_add_media at mod load time 2024-02-13 22:44:10 +01:00
.gitlab-ci.yml Remove GitLab CI and redirect GitLab pages to api.minetest.net 2024-01-10 20:52:08 +00:00
.luacheckrc Allow toggling touchscreen mode at runtime (#14075) 2024-02-22 15:44:49 +00:00
.mailmap Update credits tab and mailmap 2023-03-29 23:19:11 +02:00
CMakeLists.txt Use newer IrrlichtMt 2024-02-26 20:47:47 +01:00
CNAME Build MkDocs Lua API docs using GitHub CI, deploy to api.minetest.net (#13675) 2023-09-18 19:17:18 +03:00
COPYING.LESSER Added copy of LGPL-2.1 (#12950) 2022-11-16 13:09:53 -05:00
Dockerfile Update Docker image base 2024-02-17 12:40:18 +01:00
LICENSE.txt Add package update detection on Content tab (#13807) 2023-10-28 17:33:44 +01:00
minetest.conf.example Remove controls listed in the pause menu (no touchscreen) (#13282) 2024-01-05 20:10:07 +00:00
README.md Write down some developer documentation 2024-01-14 13:17:53 +01:00

Minetest

Build Status Translation status License

Minetest is a free open-source voxel game engine with easy modding and game creation.

Copyright (C) 2010-2022 Perttu Ahola celeron55@gmail.com and contributors (see source file comments and the version control log)

Table of Contents

  1. Further Documentation
  2. Default Controls
  3. Paths
  4. Configuration File
  5. Command-line Options
  6. Compiling
  7. Docker
  8. Version Scheme

Further documentation

Default controls

All controls are re-bindable using settings. Some can be changed in the key config dialog in the settings tab.

Button Action
Move mouse Look around
W, A, S, D Move
Space Jump/move up
Shift Sneak/move down
Q Drop itemstack
Shift + Q Drop single item
Left mouse button Dig/punch/use
Right mouse button Place/use
Shift + right mouse button Build (without using)
I Inventory menu
Mouse wheel Select item
0-9 Select item
Z Zoom (needs zoom privilege)
T Chat
/ Command
Esc Pause menu/abort/exit (pauses only singleplayer game)
+ Increase view range
- Decrease view range
K Enable/disable fly mode (needs fly privilege)
J Enable/disable fast mode (needs fast privilege)
H Enable/disable noclip mode (needs noclip privilege)
E Aux1 (Move fast in fast mode. Games may add special features)
C Cycle through camera modes
V Cycle through minimap modes
Shift + V Change minimap orientation
F1 Hide/show HUD
F2 Hide/show chat
F3 Disable/enable fog
F4 Disable/enable camera update (Mapblocks are not updated anymore when disabled, disabled in release builds)
F5 Cycle through debug information screens
F6 Cycle through profiler info screens
F10 Show/hide console
F12 Take screenshot

Paths

Locations:

  • bin - Compiled binaries
  • share - Distributed read-only data
  • user - User-created modifiable data

Where each location is on each platform:

  • Windows .zip / RUN_IN_PLACE source:
    • bin = bin
    • share = .
    • user = .
  • Windows installed:
    • bin = C:\Program Files\Minetest\bin (Depends on the install location)
    • share = C:\Program Files\Minetest (Depends on the install location)
    • user = %APPDATA%\Minetest or %MINETEST_USER_PATH%
  • Linux installed:
    • bin = /usr/bin
    • share = /usr/share/minetest
    • user = ~/.minetest or $MINETEST_USER_PATH
  • macOS:
    • bin = Contents/MacOS
    • share = Contents/Resources
    • user = Contents/User or ~/Library/Application Support/minetest or $MINETEST_USER_PATH

Worlds can be found as separate folders in: user/worlds/

Configuration file

  • Default location: user/minetest.conf
  • This file is created by closing Minetest for the first time.
  • A specific file can be specified on the command line: --config <path-to-file>
  • A run-in-place build will look for the configuration file in location_of_exe/../minetest.conf and also location_of_exe/../../minetest.conf

Command-line options

  • Use --help

Compiling

Docker

We provide a Dockerfile that can be used to build the server.

Version scheme

We use major.minor.patch since 5.0.0-dev. Prior to that we used 0.major.minor.

  • Major is incremented when the release contains breaking changes, all other numbers are set to 0.
  • Minor is incremented when the release contains new non-breaking features, patch is set to 0.
  • Patch is incremented when the release only contains bugfixes and very minor/trivial features considered necessary.

Since 5.0.0-dev and 0.4.17-dev, the dev notation refers to the next release, i.e.: 5.0.0-dev is the development version leading to 5.0.0. Prior to that we used previous_version-dev.