Difference between revisions of "Minetest Game development"

From Minetest Developer Wiki
Jump to navigation Jump to search
(Created page with "This page describes how development of minetest_game is done. == Direction == * Ensure balanced gameplay while still adding new and useful items/nodes/etc. * No changes to th...")
 
m (Shorten inclusion section)
 
(23 intermediate revisions by 8 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>)
 
  
== Maintainer rules ==
+
== Criteria for inclusion ==
* Pulls are never merged with 'git merge', merge them with 'git am' (like in minetest or minetest_game)
+
As of May 2022, only bugfixes and basic maintenance stuff are accepted. See the [[#Development]] section.
* Fixes can be pushed by every maintainer
+
 
* History rewrite only within 30 minutes (notice the other maintainers before doin)
+
=== Old criteria (before maintenance mode) ===
* New features will only go in if at least 50% agree to the feature
+
* '''Balance''' - Ensure balanced gameplay while still adding new and useful items/nodes/etc
* Heavy game changes (e.g. a workbench) don't go in if one maintainer votes against
+
* '''Semi-minimalism''' - No additions that are decided to be too much (e.g. adding homedecor in its entirety)
* The previous rule also applies to new maintainers
+
* '''Stability''' - Focus on stability and completeness (no half-finished stuff)
* Official channel for development is #minetest-dev
+
* '''Extendability''' - Improve/add API to allow mods to extend the base features (e.g. API for new crops for <i>farming</i>)
+
 
=== Commit guidelines ===
+
== Basic Concepts ==
* Commit messages begin with a capital letter and are in the present tense
+
* '''Medieval''' - Minetest Game is generally agreed to be late-medieval
* Squash similar commits before pushing
+
* '''Alien''' - Mese is an alien crystal / meteorite
* Notice other maintainers before you push something
+
 
 +
== 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 [https://github.com/minetest/minetest_game/pull/793 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: [https://forum.minetest.net/viewtopic.php?f=18&t=25152]
 +
 
 +
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]]

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).