Difference between revisions of "Minetest Game development"

From Minetest Developer Wiki
Jump to navigation Jump to search
m (Shorten inclusion section)
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:minetest_game Development}}
+
This page describes the values of Minetest Game. These may be changed when the majority of MTG developers agree.
  
This page describes how development of minetest_game is done.
+
== 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
  
== Direction ==
+
== Criteria for inclusion ==
* Ensure balanced gameplay while still adding new and useful items/nodes/etc.
+
As of May 2022, only bugfixes and basic maintenance stuff are accepted. See the [[#Development]] section.
* No changes to the basic concepts (e.g. workbench won't get added)
 
* No additions that are decided to be too much (e.g. adding homedecor in its entirety)
 
* 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>)
 
  
 +
=== 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>)
  
'''Note:''' To prevent problems with the development like before minetest_game is maintained by only five people (BlockMen, sfan5, nore, PilzAdam, ShadowNinja).
+
== 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 [https://github.com/minetest/minetest_game/pull/793 chests]
 +
* Entities should be voxel-ish
 +
* Textures should be 16x16
  
== Maintainer rules ==
+
== Development ==
* Pulls are never merged with 'git merge', merge them with 'git am' (like in minetest)
+
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]
* Fixes can be pushed by every maintainer
+
 
* History rewrite can only be done within 10 minutes (notify the other maintainers before doing so)
+
See also [[Git]] and [[Git Guidelines]].
* 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
+
'''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).
* The previous rule also applies to new maintainers
 
* Official channel for development is #minetest-dev
 
 
=== Commit guidelines ===
 
* Commit messages begin with a capital letter and are in the present tense
 
* 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).