Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

import more stuff from wiki #123

Merged
merged 2 commits into from
Dec 31, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
69 changes: 69 additions & 0 deletions content/licensing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
---
title: Licensing
aliases:
- /Licensing
---

# Licensing


Recently a considerable number of Luanti-based games have been appearing in the Android playstore, and Google Play. See the [list of Luanti forks](https://wiki.luanti.org/Overview_of_Luanti_forks "Overview of Luanti forks") for examples of these.

_Please look at: [FlightGear](http://www.flightgear.org/flightprosim.html) as they have the same issue as Luanti has._

Complying with the License
--------------------------

The code of both the Luanti engine and Minetest Game are licensed under [LGPL 2.1+ free software license](https://www.gnu.org/licenses/lgpl-2.1.html). Other components may be similarly licensed, however this document does not cover them. **Note that this document is only intended for informational purposes**, for the real legally binding terms you should read the [LGPL 2.1+ license](https://www.gnu.org/licenses/lgpl-2.1.html).

* You must link to the source code behind your software
* Which must also be licensed under LGPL 2.1 or later, or a compatible license. Also see _"what if I use proprietary source code/libraries?"_.
* If any modifications were made to the Luanti engine or Minetest Game, you must state this inside of your application, and provide a means to download the \*\*modified\*\* source code.
* If you did not modify any source code, you must still link to the source code behind the software - however this can be the official Luanti repo if unmodified
* You must not remove any copyright notices.
* You must state significant changes to the software.
* You must not mix proprietary and LGPLv2.1+ code, see _"what if I use proprietary source code/libraries?"_.
* You should place the following attribution on any pages where the software can be downloaded, including but not limited to Google Play or a website:

> This \[app/game/...\] uses the Luanti engine \[and Minetest Game\], Copyright 2010-2018 Perttu Ahola and contributors, licensed under LGPLv2.1+

**It is an infringement to only link back to the original source code if you made modifications**

### Where should I put any links?

* Any locations where the software is downloaded, including but not limited to Google Play or a website.
* You should place a link in the main menu (for example, in the credits tab).

### What if I use proprietary source code/libraries?

* **Don't mix proprietary code with LGPL code.** For example, if you use a proprietary ad library, then you can only call it from proprietary code.
* **Any LGPL code must be replaceable.** The user must be able to use their own version of any LGPL code with your software. You must also provide documentation on how to do this.
* Any proprietary code you wrote must not forbid reverse-compilation for the purpose of debugging modifications to the LGPL code.
* You must **fully and prominently attribute** the Luanti project if your software contains any proprietary code.

This, in affect, means that you will need to completely rewrite the Java section of the app and just use Luanti as an NDK library. Make sure you include instructions on how to replace any LGPLv2.1+ code.

The legal text behind this is in [section 4](https://www.gnu.org/licenses/lgpl.html#section4). Also see [\[1\]](https://opensource.stackexchange.com/questions/4357/how-can-lgpl-and-proprietary-licenses-be-combined)

### See also

* [https://tldrlegal.com/license/gnu-lesser-general-public-license-v3-(lgpl-3)](https://tldrlegal.com/license/gnu-lesser-general-public-license-v3-\(lgpl-3\))
* [https://www.gnu.org/licenses/lgpl-2.1.html](https://www.gnu.org/licenses/lgpl-2.1.html)
* [https://softwareengineering.stackexchange.com/questions/86142/what-exactly-do-i-need-to-do-if-i-use-a-lgpl-licenced-library](https://softwareengineering.stackexchange.com/questions/86142/what-exactly-do-i-need-to-do-if-i-use-a-lgpl-licenced-library)

What to do if I spot a program that is possibly infringing Luanti's license?
----------------------------------------------------------------------------

If you think that a certain program is infringing on Luanti's LGPL 2.1 license, please check with the program's website to see if it is licensed under similar terms, and if the source code is being distributed.If the license seems to be proprietary, and if the developer alleges that the program is their own work, then contact [celeron55](mailto:[email protected]). Alternatively, join the [Luanti IRC channel](http://webchat.freenode.net/?channels=#minetest) and report it there. It doesn't matter if anyone replies or not, it will be logged and the community will check on it themselves. There is also an attempt to list forks of Luanti at the "[Making a list of Luanti forks for Android](https://forum.minetest.net/viewtopic.php?p=242219#p242219)" thread in the forums. If the programm you discovered is missing there you could add it.

### What not to do if a program is infringing Luanti's license

**DO NOT TAKE ANY ACTION AGAINST THE DEVELOPER** - You must report it to the Luanti devs instead.

Even if it is as clear as day that a certain program is using code and artwork from Luanti and is not distributing it under similar conditions, please do not attempt, or do the following:

1. Do not launch a witch-hunt. This is the 21st century. Please behave appropriately.
2. Do not attempt to crack, grief, or crash their servers.
3. Do not attempt to contact the infringing program's developer. Any contact made with the developer shall be after consensus with respected members of the community at large and the Core Development Team.

The above has largely only resulted in a lot of drama, mostly ending with the infringing developer gaining the upper hand and getting away with using Luanti's code while violating the license. Please don't do it.
8 changes: 8 additions & 0 deletions content/main-menu-music.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
---
title: Main menu music
aliases:
- /Main_menu_music
---

# Main menu music
Luanti supports music in the main menu, which can [be provided by games](https://minetest.gitlab.io/minetest/games/#menu-music) (5.5.0+). Previously it was possible to provide main menu music in [Sound Packs](https://wiki.luanti.org/Sound_Packs "Sound Packs") but this broke alongside the implementation of game-specific main menu music.
96 changes: 96 additions & 0 deletions content/overview-of-luanti-forks.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,96 @@
---
title: Overview of Luanti forks
aliases:
- /Overview_of_Luanti_forks
- /Overview_of_Minetest_forks
---

# Overview of Luanti forks

A software is said to be a **fork** if it is a derivation of a copy of another software; that is, if it is based on its source code and other related data. Luanti has seen some forks in its history. This article gives an overview of some of the known forks of Luanti.

What is a Luanti fork?
----------------------

As said, above, a fork is another copy of software that is edited. For Luanti, it is the same. Except a few mods put together is not called a fork, that would be a modpack. A fork is a Core engine change(s) that are not official and will not be released as a version of Luanti unless submitted and accepted in a pull request.

List of projects
----------------

The following projects are known Luanti forks, which may or may not be active at the moment.

### Voxelands

**[Voxelands](http://www.voxelands.com/)** was started under the name “Minetest Classic” on the 15th of April 2013 (date of [earliest recorded commit](https://gitorious.org/minetest-classic/minetest-classic/commit/2c4e0bcbc94abca621aeaa6f5159d2637179da47)) by darkrose as a fork of the latest stable release of the 0.3 series of Minetest-c55 (“Minetest-c55” was the earlier name of Luanti).

The fork was motivated by a dissatisfaction of Luanti becoming more and more a game engine rather than a game. Voxelands developers also claim that with the start of 0.4 series (and the introduction of the [Lua modding API](https://wiki.luanti.org/Mods "Mods")), Luanti has decreased in performance, which is another key motivation for Voxelands. Voxelands is incompatible with Luanti and now quite different.

Key goals of Voxelands are keeping the game at least as performant as the Minetest-c55 0.3 series, adding new content, maintaining balanced gameplay with a focus of in-world functionality, backporting bugfixes and some features from the 0.4 series and maintaining backwards compatibility to the 0.3 series at the network protocol level.

### Blocklife

[Blocklife](https://forum.minetest.net/viewtopic.php?f=14&t=12021) was first announced on the Luanti forum on Thu Apr 30, 2015 by gibucsoft. It started with only few noticeable changes to version 0.4.7 and came with a game that included some more mods than Minetst Game. The most interesting feature was the use of two hands that could each be used seperately. On 23th May 2018 gibucsoft anounced to once more start developing. This time the block size might get reduced to a tenth in sidelength. The goal would be to have a more reallistic shaped “round” world.

### Freeminer

**[Freeminer](http://freeminer.org/)** is a fork of version 0.4.8. It's no longer maintained.

The project goals have been vaguely described as something along the lines of “To create a fun and playable game” and it is unclear what has motivated the fork. A list of changes compared to Luanti was published: [\[1\]](http://forum.freeminer.org/threads/full-list-of-changes-from-minetest.110/)

[Freeminer is also available for Android](https://f-droid.org/packages/org.freeminer.freeminer/), but it's no longer maintained either.

### Minetest-delta

[Minetest-delta](https://github.com/erlehmann/minetest-delta) was a fork of Luanti, maintained in mid-2011, with the goal of adding more experimental features to Luanti. Some contributions like papyrus, cacti and jungles have since been merged in Luanti.

### Minetest-M13

An ancient fork. No activity recorded since 2012.

### Various forks of the Android version

There are a lot of Android forks. Sadly, there are a lot of low-quality proprietary Luanti forks. Many of them are known to have extremely annoying advertisements (which often make the game near-unplayable) or even in-app-purchases. **Those are not part of official Luanti!**

The _official_ Android versions can be found here:

* [Luanti on F-Droid](https://f-droid.org/packages/net.minetest.minetest/)
* [Luanti on Google Play](https://play.google.com/store/apps/details?id=net.minetest.minetest)

**Important: Ads, in-app purchases or other anti-features are not, and will never be part of Luanti!** If you see ads, double-check if you have _really_ installed Luanti, and not something else. Luanti is a community-driven free software project and we are way too proud of ourselves to ever need something like ads or in-app-purchases. :D

Many of these Luanti forks come and go rather quickly. Here are some known names in Google Play (because it changes so quickly, this list ls likely outdated and incomplete):

* Worldcraft: Exploration Lite
* WorldCraft 2 : Pocket Edition
* PixelCraft — 3D Survival!
* ► MultiCraft ― Free Miner!
* Crazy Craft on Castle World PE
* MultiCraft - Minetest France
* Cartoon Craft: Castle World PE
* Voxel Craft : Castle Build PE
* World Craft 3D
* Squeake Craft PLUS

[Discussion thread](https://forum.minetest.net/viewtopic.php?f=3&t=16707).

Not much is known about these forks so far (feel free to edit this wiki page!). But we do know all these forks are illegetimate proprietary forks and/or they contain anti-features such as ads. For most of these, there's no source code provided, there's a proprietary license or no license at all. None of these problems exist in Luanti.

Note we are absolutely not against unofficial forks of Luanti and creating awesome new things with it (that's the whole point of being free software!). But for Android, we simply have not been impressed by the results so far. However, if you think you found a great Luanti fork for Android, please tell us in the [forums](https://forum.minetest.net/viewtopic.php?f=3&t=16707).

If you want to avoid proprietary forks with annoying anti-features altogether, we recommend you start to use [F-Droid](https://f-droid.org/) instead of Google Play. F-Droid software is a repository maintained by free software zealots like us in which fishy proprietary software is not allowed in the first place. :-)

### Various forks of the iOS version

Just like with Android, we also had people forking Luanti for iOS. The similar problems apply here.

Here's a list (we can't recommend any of these):

* [Buildcraft](https://itunes.apple.com/us/app/buildcraft-multiplayer-block-game/id740372768?mt=8)
* [Worldcraft 2](https://itunes.apple.com/us/app/worldcraft-survival-2/id900353132?mt=8)
* [Worldcraft Pocket Edition](https://itunes.apple.com/us/app/worldcraft-pocket-edition/id796349324?mt=8)
* [Exploration](https://itunes.apple.com/us/app/exploration-mind-world-of-craft-survival-game/id880642020?mt=8)
* FreeCraft (No iTunes Store link at the moment)

None of these are free software either. Buildcraft even forces you to perform an in-app purchases to make its ads go away.

[Discussion thread](https://forum.minetest.net/viewtopic.php?f=3&t=16707).
16 changes: 16 additions & 0 deletions content/pointing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: Pointing
aliases:
- /Pointing
---

# Pointing
**Pointing** means to look at something with the crosshair (which is in the center of your screen) on it while being close enough to it. When something is pointed, it is highlighted, either by a wireframe or by some sort of “halo”. Pointing things is neccessary for tasks like [mining](https://wiki.luanti.org/Mining "Mining"), [building](https://wiki.luanti.org/Building "Building"), [using](https://wiki.luanti.org/Using "Using") …

The default distance for pointing is less than 4 blocks away. In [Minetest Game](https://wiki.luanti.org/Games/Minetest_Game "Games/Minetest Game"), this distance increases to 10 when using [creative mode](https://wiki.luanti.org/Creative_mode "Creative mode"). It is possible for items and held nodes to have their own pointing range.

Most [blocks](https://wiki.luanti.org/Blocks "Blocks") can be pointed at, but not all. [Liquids](https://wiki.luanti.org/Liquid "Liquid") are usually not be pointed at, but there are [special items](https://wiki.luanti.org/Category:Liquid_pointers "Category:Liquid pointers") which are capable of pointing to liquids. Examples are [buckets](https://wiki.luanti.org/Bucket "Bucket") and [boats](https://wiki.luanti.org/Boat "Boat"). A few blocks like [Air](https://wiki.luanti.org/Air "Air") can never be pointed. Also, [items](https://wiki.luanti.org/Items "Items") on the ground can be pointed (in order to collect them).

It is only possible to point at one thing at a time.

By default, a thin black rectangular wireframe will be shown around the block or entity which you currently point. The colour and thickness of the selection box can be changed with `selectionbox_color` and `selectionbox_width`. It is also possible to change it from an outline to a highlight which tints the pointed node with a configurable colour.
Loading
Loading