Difference between revisions of "Minetest Game development"

From Minetest Developer Wiki
Jump to navigation Jump to search
(Make sure the name “Minetest Game” is used consistently throughout this page)
m (Shorten inclusion section)
 
(13 intermediate revisions by 4 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 four people (sfan5, nore, PilzAdam, ShadowNinja).
+
=== 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>)
  
 +
== Basic Concepts ==
 +
* '''Medieval''' - Minetest Game is generally agreed to be late-medieval
 +
* '''Alien''' - Mese is an alien crystal / meteorite
  
== Maintainer rules ==
+
== Graphic Style ==
* Pulls are never merged with 'git merge', merge them with 'git am' (like in minetest)
+
* 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]
* Fixes can be pushed by every maintainer
+
* Entities should be voxel-ish
* History rewrite can only be done within 10 minutes (notify the other maintainers before doing so)
+
* Textures should be 16x16
* New features will only go in if 50% of present maintainers (two minimum) agree to the feature
+
 
* Heavy game changes (e.g. a workbench) don't go in if one maintainer votes against
+
== Development ==
* The previous rule also applies to new maintainers
+
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]
* Official channel for development is #minetest-dev
+
 
+
See also [[Git]] and [[Git Guidelines]].
=== Commit guidelines ===
+
 
* Commit messages begin with a capital letter and are in the present tense
+
'''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).
* Squash similar commits before pushing
 
* Notify other maintainers before you push something
 
 
[[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).