MTSR/minetest_modding_book
4
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Improve issues caused by cleanup commit

Browse Source
This commit is contained in:
rubenwardy 2021-01-05 20:51:13 +00:00
parent 658c35e35c
commit 80bc6d32d8
2 changed files with 35 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
_en/map/objects.md
View File

@ -130,16 +130,17 @@ When an entity is emerged (ie: loaded or created), a new table is created for
that entity that *inherits* from the definition table. that entity that *inherits* from the definition table.
<!-- <!--
This inheritance is done using a Metatables are an important Lua feature that you will need This inheritance is done using a metatables.
to be aware of, as it is an essential part of the Lua language. Metatables are an important Lua feature that you will need to be aware of, as it
In layman's terms, a metatable allows you to control how the table behaves when is an essential part of the Lua language. In layman's terms, a metatable allows
using certain Lua syntax. The most common use of metatables is the ability to use you to control how the table behaves when using certain Lua syntax. The most
another table as a prototype, defaulting to the other table's properties and methods when common use of metatables is the ability to use another table as a prototype,
they do not exist in the current table. defaulting to the other table's properties and methods when they do not exist in
the current table.
Say you want to access `a.x`. If the table `a` has that member, then it will be Say you want to access `a.x`. If the table `a` has that member, then it will be
returned as normal. However, if the table doesn't have that member and the returned as normal. However, if the table doesn't have that member and the
metatable lists a table `b` as a prototype, then table `b` will be checked to see metatable lists a table `b` as a prototype, then table `b` will be checked to
if it has that member. see if it has that member.
--> -->
Both an ObjectRef and an entity table provide ways to get the counterpart: Both an ObjectRef and an entity table provide ways to get the counterpart:

51
_en/quality/releasing.md
View File

@ -42,11 +42,16 @@ able to modify it and release the modified version.)
Please note that **public domain is not a valid licence**, because the definition varies Please note that **public domain is not a valid licence**, because the definition varies
in different countries. in different countries.
It is important to note that WTFPL is strongly discouraged and people may
choose not to use your mod if it has this license.
### LGPL and CC-BY-SA ### LGPL and CC-BY-SA
This is a common license combination in the Minetest community, and is what This is a common license combination in the Minetest community, and is what
Minetest and Minetest Game use. Minetest and Minetest Game use.
You license your code under LGPL 2.1 and your art under CC-BY-SA. You license your code under LGPL 2.1 and your art under CC-BY-SA.
This means that: This means that:
* Anyone can modify, redistribute and sell modified or unmodified versions. * Anyone can modify, redistribute and sell modified or unmodified versions.
@ -55,40 +60,36 @@ This means that:
### CC0 ### CC0
These licenses allow anyone to do what they want with your mod, This license can be used for both code and art, and allows anyone to do what
which means they can modify, redistribute, sell, or leave-out attribution. they want with your work. This means they can modify, redistribute, sell, or
These licenses can be used for both code and art. leave-out attribution.
It is important to note that WTFPL is strongly discouraged and people may
choose not to use your mod if it has this license.
### MIT ### MIT
This is a common license for mod code. The only restriction it places on users This is a common license for code. The only restriction it places on users
of your mod is that they must include the same copyright notice and license of your code is that they must include the same copyright notice and license
in any copies of the mod or of substantial parts of the mod. in any copies of the code or of substantial parts of the code.
## Packaging ## Packaging
There are some files that are recommended to include in your mod There are some files that are recommended to include in your mod or game
before you release it. before you release it.
### README.txt ### README.txt
The README file should state: The README file should state:
* What the mod does. * What the mod/game does, how to use it.
* What the license is. * What the license is.
* What dependencies there are. * Optionally:
* How to install the mod. * where to report problems or get help.
* Current version of the mod. * credits
* Optionally, the where to report problems or get help.
### mod.conf / game.conf ### mod.conf / game.conf
Make sure you add a description key to explain what your mod does. Be concise without being vague. Make sure you add a description key to explain what your mod or game does. Be
It should be short because it will be displayed in the content installer which has concise without being vague. It should be short because it will be displayed in
limited space. the content installer which has limited space.
Good example: Good example:
@ -103,7 +104,7 @@ Avoid this:
Screenshots should be 3:2 (3 pixels of width for every 2 pixels of height) Screenshots should be 3:2 (3 pixels of width for every 2 pixels of height)
and have a minimum size of 300 x 200px. and have a minimum size of 300 x 200px.
The screenshot is displayed in the mod store. The screenshot is displayed inside of Minetest as a thumbnail for the content.
## Uploading ## Uploading
@ -115,7 +116,7 @@ others which may be added by forum moderators:
* **Stable** - The hosting website should be unlikely to shut down without warning. * **Stable** - The hosting website should be unlikely to shut down without warning.
* **Direct link** - You should be able to click a link and download the file * **Direct link** - You should be able to click a link and download the file
without having to view another page. without having to view another page.
* **Virus Free** - Mods with malicious content will be removed from the forum. * **Virus Free** - Scammy upload hosts may contain insecure adverts.
ContentDB allows you to upload zip files, and meets these criteria. ContentDB allows you to upload zip files, and meets these criteria.
@ -135,16 +136,16 @@ Using a graphical interface on Windows to upload your code.
## Releasing on ContentDB ## Releasing on ContentDB
ContentDB is the official place to find and distribute mods and games. Users can ContentDB is the official place to find and distribute content such as mods,
find content using the website, or download and install using the integration games, and texture packs. Users can find content using the website, or download
built into the Minetest main menu. and install using the integration built into the Minetest main menu.
Sign up to [ContentDB](https://content.minetest.net) and add your mod or game. Sign up to [ContentDB](https://content.minetest.net) and add your content.
Make sure to read the guidance given in the Help section. Make sure to read the guidance given in the Help section.
## Forum Topic ## Forum Topic
You can also create a forum topic to let users discuss your mod or game. You can also create a forum topic to let users discuss your creation.
Mod topics should be created in ["WIP Mods"](https://forum.minetest.net/viewforum.php?f=9) (Work In Progress) Mod topics should be created in ["WIP Mods"](https://forum.minetest.net/viewforum.php?f=9) (Work In Progress)
forum, and Game topics in the ["WIP Games"](https://forum.minetest.net/viewforum.php?f=50) forum. forum, and Game topics in the ["WIP Games"](https://forum.minetest.net/viewforum.php?f=50) forum.