Difference between revisions of "Minetest Game development"

From Minetest Developer Wiki
Jump to navigation Jump to search
(Add me)
m (Shorten inclusion section)
 
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This page describes how development of Minetest Game is done.
+
This page describes the values of Minetest Game. These may be changed when the majority of MTG developers agree.
  
== Direction ==
+
== Core Gameplay Values ==
* Ensure balanced gameplay while still adding new and useful items/nodes/etc.
+
* '''Exploration''' - interesting mapgen/biomes
* No changes to the basic concepts (e.g. workbench won't get added)
+
* '''Creativity''' - enough nodes without contradicting semi-minimalism
* No additions that are decided to be too much (e.g. adding homedecor in its entirety)
+
* '''Immersion''' - adding feedback such as sounds, mobs, and interactivity to make the world feel alive
* Focus on stability and completeness (no half-finished stuff)
 
* Improve/add API to allow mods to extend the base features (e.g. API for new crops for <i>farming</i>)
 
  
 +
== Criteria for inclusion ==
 +
As of May 2022, only bugfixes and basic maintenance stuff are accepted. See the [[#Development]] section.
  
'''Note:''' To prevent problems with the development like before Minetest Game is maintained by only seven people (sfan5, nore, PilzAdam, ShadowNinja, paramat, sofar, rubenwardy).
+
=== Old criteria (before maintenance mode) ===
 +
* '''Balance''' - Ensure balanced gameplay while still adding new and useful items/nodes/etc
 +
* '''Semi-minimalism''' - No additions that are decided to be too much (e.g. adding homedecor in its entirety)
 +
* '''Stability''' - Focus on stability and completeness (no half-finished stuff)
 +
* '''Extendability''' - Improve/add API to allow mods to extend the base features (e.g. API for new crops for <i>farming</i>)
  
== Maintainer rules ==
+
== Basic Concepts ==
* Pulls are never merged with 'git merge', merge them with 'git am' (like in minetest)
+
* '''Medieval''' - Minetest Game is generally agreed to be late-medieval
* Fixes can be pushed by every maintainer
+
* '''Alien''' - Mese is an alien crystal / meteorite
* History rewrite can only be done within 10 minutes (notify the other maintainers before doing so)
+
 
* New features will only go in if 50% of present maintainers (two minimum) agree to the feature
+
== Graphic Style ==
* Heavy game changes (e.g. a workbench) don't go in if one maintainer votes against
+
* All nodes should fit the voxel grid or a sub division. Note this is a general rule, there are cases when it's OK such as [https://github.com/minetest/minetest_game/pull/793 chests]
* The previous rule also applies to new maintainers
+
* Entities should be voxel-ish
* Official channel for development is #minetest-dev
+
* Textures should be 16x16
+
 
=== Commit guidelines ===
+
== Development ==
* Commit messages begin with a capital letter and are in the present tense
+
As of May 2022, Minetest Game is in "maintenance mode" since July 2020. This means no new features are accepted, only bugfixes and basic maintenance. Translations count as maintenance and are thus accepted. Source: [https://forum.minetest.net/viewtopic.php?f=18&t=25152]
* Squash similar commits before pushing
+
 
* Notify other maintainers before you push something
+
See also [[Git]] and [[Git Guidelines]].
 +
 
 +
'''Note:''' To prevent problems with the development like before Minetest Game is maintained by only eight people (sfan5, nore, ShadowNinja, paramat, sofar, rubenwardy, Krock/SmallJoker, Shara/Ezhh).
 
[[Category:Rules and Guidelines]]
 
[[Category:Rules and Guidelines]]

Latest revision as of 11:53, 24 May 2022

This page describes the values of Minetest Game. These may be changed when the majority of MTG developers agree.

Core Gameplay Values

  • Exploration - interesting mapgen/biomes
  • Creativity - enough nodes without contradicting semi-minimalism
  • Immersion - adding feedback such as sounds, mobs, and interactivity to make the world feel alive

Criteria for inclusion

As of May 2022, only bugfixes and basic maintenance stuff are accepted. See the #Development section.

Old criteria (before maintenance mode)

  • Balance - Ensure balanced gameplay while still adding new and useful items/nodes/etc
  • Semi-minimalism - No additions that are decided to be too much (e.g. adding homedecor in its entirety)
  • Stability - Focus on stability and completeness (no half-finished stuff)
  • Extendability - Improve/add API to allow mods to extend the base features (e.g. API for new crops for farming)

Basic Concepts

  • Medieval - Minetest Game is generally agreed to be late-medieval
  • Alien - Mese is an alien crystal / meteorite

Graphic Style

  • All nodes should fit the voxel grid or a sub division. Note this is a general rule, there are cases when it's OK such as chests
  • Entities should be voxel-ish
  • Textures should be 16x16

Development

As of May 2022, Minetest Game is in "maintenance mode" since July 2020. This means no new features are accepted, only bugfixes and basic maintenance. Translations count as maintenance and are thus accepted. Source: [1]

See also Git and Git Guidelines.

Note: To prevent problems with the development like before Minetest Game is maintained by only eight people (sfan5, nore, ShadowNinja, paramat, sofar, rubenwardy, Krock/SmallJoker, Shara/Ezhh).