Skip to content

Commit

Permalink
Rename to Minetest Game
Browse files Browse the repository at this point in the history
Rename in game.conf and documentation
Update game_api.txt documentation for bucket API and tree functions
Fix tab, space and comment formatting in game_api.txt
Rename in mod READMEs
  • Loading branch information
paramat committed Sep 30, 2015
1 parent 93a2c40 commit 8e51f31
Show file tree
Hide file tree
Showing 21 changed files with 106 additions and 93 deletions.
27 changes: 14 additions & 13 deletions README.txt
@@ -1,23 +1,24 @@
The main game for the Minetest game engine [minetest_game]
==========================================================
Minetest Game [minetest_game]
=============================
The main subgame for the Minetest engine
========================================

To use this game with Minetest, insert this repository as
/games/minetest_game
in the Minetest Engine.
To use this subgame with the Minetest engine, insert this repository as
/games/minetest_game

The Minetest Engine can be found in:
https://github.com/minetest/minetest/
The Minetest engine can be found in:
https://github.com/minetest/minetest/

Compatibility
--------------
The minetest_game github master HEAD is generally compatible with the github
master HEAD of minetest.
The Minetest Game github master HEAD is generally compatible with the github
master HEAD of the Minetest engine.

This comment has been minimized.

Copy link
@cheapie

cheapie Oct 1, 2015

Shouldn't this be referring to the name of the repository like it was before?


Additionally, when the minetest engine is tagged to be a certain version (eg.
0.4.10), minetest_game is tagged with the version too.
Additionally, when the Minetest engine is tagged to be a certain version (eg.
0.4.10), Minetest Game is tagged with the version too.

When stable releases are made, minetest_game is packaged and made available in
http://minetest.net/download
When stable releases are made, Minetest Game is packaged and made available in
http://minetest.net/download
and in case the repository has grown too much, it may be reset. In that sense,
this is not a "real" git repository. (Package maintainers please note!)

Expand Down
2 changes: 1 addition & 1 deletion game.conf
@@ -1 +1 @@
name = Minetest
name = Minetest Game
103 changes: 58 additions & 45 deletions game_api.txt
@@ -1,11 +1,11 @@
minetest_game API
======================
Minetest Game API
=================
GitHub Repo: https://github.com/minetest/minetest_game

Introduction
------------
The minetest_game gamemode offers multiple new possibilities in addition to Minetest's built-in API, allowing you to
add new plants to farming mod, buckets for new liquids, new stairs and custom panes.
The Minetest Game subgame offers multiple new possibilities in addition to the Minetest engine's built-in API,
allowing you to add new plants to farming mod, buckets for new liquids, new stairs and custom panes.
For information on the Minetest API, visit https://github.com/minetest/minetest/blob/master/doc/lua_api.txt
Please note:
[XYZ] refers to a section the Minetest API
Expand All @@ -17,23 +17,24 @@ Bucket API
The bucket API allows registering new types of buckets for non-default liquids.

bucket.register_liquid(
"default:lava_source", -- Source node name
"default:lava_flowing", -- Flowing node name
"bucket:bucket_lava", -- Name to be used for bucket
"bucket_lava.png", -- Bucket texture (for wielditem and inventory_image)
"Lava Bucket" -- Bucket description
"default:lava_source", -- name of the source node
"default:lava_flowing", -- name of the flowing node
"bucket:bucket_lava", -- name of the new bucket item (or nil if liquid is not takeable)
"bucket_lava.png", -- texture of the new bucket item (ignored if itemname == nil)
"Lava Bucket", -- text description of the bucket item
{lava_bucket = 1} -- groups of the bucket item, OPTIONAL
)

Beds API
--------
beds.register_bed(
"beds:bed", -- Bed name
def: See [#Bed definition] -- Bed definition
"beds:bed", -- Bed name
def: See [#Bed definition] -- Bed definition
)

beds.read_spawns() -- returns a table containing players respawn positions
beds.kick_players() -- forces all players to leave bed
beds.skip_night() -- sets world time to morning and saves respawn position of all players currently sleeping
beds.read_spawns() -- returns a table containing players respawn positions
beds.kick_players() -- forces all players to leave bed
beds.skip_night() -- sets world time to morning and saves respawn position of all players currently sleeping

#Bed definition
---------------
Expand All @@ -50,11 +51,11 @@ Beds API
}
},
nodebox = {
bottom = regular nodebox, see [Node boxes], -- bottm part of bed
top = regular nodebox, see [Node boxes], -- top part of bed
bottom = regular nodebox, see [Node boxes], -- bottm part of bed
top = regular nodebox, see [Node boxes], -- top part of bed
},
selectionbox = regular nodebox, see [Node boxes], -- for both nodeboxes
recipe = { -- Craft recipe
selectionbox = regular nodebox, see [Node boxes], -- for both nodeboxes
recipe = { -- Craft recipe
{"group:wool", "group:wool", "group:wool"},
{"group:wood", "group:wood", "group:wood"}
}
Expand Down Expand Up @@ -104,9 +105,9 @@ doors.register_trapdoor(name, def)
sound_open = sound to play when opening the trapdoor, OPTIONAL,
sound_close = sound to play when closing the trapdoor, OPTIONAL,
-> You can add any other node definition properties for minetest.register_node,
such as wield_image, inventory_image, sounds, groups, description, ...
Only node_box, selection_box, tiles, drop, drawtype, paramtype, paramtype2, on_rightclick
will be overwritten by the trapdoor registration function
such as wield_image, inventory_image, sounds, groups, description, ...
Only node_box, selection_box, tiles, drop, drawtype, paramtype, paramtype2, on_rightclick
will be overwritten by the trapdoor registration function
}

Farming API
Expand All @@ -122,11 +123,11 @@ farming.register_plant(name, Plant definition)
#Hoe Definition
---------------
{
description = "", -- Description for tooltip
inventory_image = "unknown_item.png", -- Image to be used as wield- and inventory image
max_uses = 30, -- Uses until destroyed
material = "", -- Material for recipes
recipe = { -- Craft recipe, if material isn't used
description = "", -- Description for tooltip
inventory_image = "unknown_item.png", -- Image to be used as wield- and inventory image
max_uses = 30, -- Uses until destroyed
material = "", -- Material for recipes
recipe = { -- Craft recipe, if material isn't used
{"air", "air", "air"},
{"", "group:stick"},
{"", "group:stick"},
Expand All @@ -136,12 +137,12 @@ farming.register_plant(name, Plant definition)
#Plant definition
-----------------
{
description = "", -- Description of seed item
inventory_image = "unknown_item.png", -- Image to be used as seed's wield- and inventory image
steps = 8, -- How many steps the plant has to grow, until it can be harvested
description = "", -- Description of seed item
inventory_image = "unknown_item.png", -- Image to be used as seed's wield- and inventory image
steps = 8, -- How many steps the plant has to grow, until it can be harvested
^ Always provide a plant texture for each step, format: modname_plantname_i.png (i = stepnumber)
minlight = 13, -- Minimum light to grow
maxlight = default.LIGHT_MAX -- Maximum light to grow
minlight = 13, -- Minimum light to grow
maxlight = default.LIGHT_MAX -- Maximum light to grow
}

Screwdriver API
Expand All @@ -155,7 +156,7 @@ on_rotate(pos, node, user, mode, new_param2)
^ mode: screwdriver.ROTATE_FACE or screwdriver.ROTATE_AXIS
^ new_param2: the new value of param2 that would have been set if on_rotate wasn't there
^ return value: false to disallow rotation, nil to keep default behaviour, true to allow
it but to indicate that changed have already been made (so the screwdriver will wear out)
it but to indicate that changed have already been made (so the screwdriver will wear out)
^ use on_rotate = screwdriver.disallow to always disallow rotation
^ use on_rotate = screwdriver.rotate_simple to allow only face rotation

Expand Down Expand Up @@ -215,10 +216,10 @@ The following nodes use the group `connect_to_raillike` and will only connect to
raillike nodes within this group and the same group value.
Use `minetest.raillike_group(<Name>)` to get the group value.

| Node type | Raillike group name
+-----------------------+----------------------------------
| default:rail | "rail"
| tnt:gunpowder | "gunpowder"
| Node type | Raillike group name
+-----------------------+--------------------
| default:rail | "rail"
| tnt:gunpowder | "gunpowder"
| tnt:gunpowder_burning | "gunpowder"

Example:
Expand Down Expand Up @@ -281,13 +282,13 @@ default.player_get_animation(player)
Model Definition
----------------
{
animation_speed = 30, -- Default animation speed, in FPS.
textures = {"character.png", }, -- Default array of textures.
visual_size = {x=1, y=1,}, -- Used to scale the model.
animation_speed = 30, -- Default animation speed, in FPS.
textures = {"character.png", }, -- Default array of textures.
visual_size = {x = 1, y = 1}, -- Used to scale the model.
animations = {
-- <anim_name> = { x=<start_frame>, y=<end_frame>, },
foo = { x= 0, y=19, },
bar = { x=20, y=39, },
-- <anim_name> = {x = <start_frame>, y = <end_frame>},
foo = {x = 0, y = 19},
bar = {x = 20, y = 39},
-- ...
},
}
Expand Down Expand Up @@ -375,10 +376,22 @@ dye.excolors
Trees
-----
default.grow_tree(pos, is_apple_tree)
^ Grows a tree or apple tree at pos
^ Grows a mgv6 tree or apple tree at pos

default.grow_jungle_tree(pos)
^ Grows a jungletree at pos
^ Grows a mgv6 jungletree at pos

default.grow_pine_tree(pos)
^ Grows a pinetree at pos
^ Grows a mgv6 pinetree at pos

default.grow_new_apple_tree(pos)
^ Grows a new design apple tree at pos

default.grow_new_jungle_tree(pos)
^ Grows a new design jungle tree at pos

default.grow_new_pine_tree(pos)
^ Grows a new design pine tree at pos

default.grow_new_acacia_tree(pos)
^ Grows a new design acacia tree at pos
4 changes: 1 addition & 3 deletions minetest.conf.example
@@ -1,6 +1,4 @@
# This file contains settings of minetest_game that can be changed in
# minetest.conf
#
# This file contains settings of Minetest Game that can be changed in minetest.conf
# By default, all the settings are commented and not functional.
# Uncomment settings by removing the preceding #.

Expand Down
4 changes: 2 additions & 2 deletions mods/beds/README.txt
@@ -1,5 +1,5 @@
Minetest mod "Beds"
===================
Minetest Game mod: beds
=======================
by BlockMen (c) 2014-2015

Version: 1.1.1
Expand Down
6 changes: 3 additions & 3 deletions mods/boats/README.txt
@@ -1,6 +1,6 @@
Minetest 0.4 mod: boats
=======================
by PilzAdam, slightly modified for NeXt
Minetest Game mod: boats
========================
by PilzAdam

License of source code:
-----------------------
Expand Down
4 changes: 2 additions & 2 deletions mods/bones/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: bones
=======================
Minetest Game mod: bones
========================

License of source code:
-----------------------
Expand Down
2 changes: 1 addition & 1 deletion mods/bucket/README.txt
@@ -1,4 +1,4 @@
Minetest 0.4 mod: bucket
Minetest Game mod: bucket
=========================

License of source code:
Expand Down
4 changes: 2 additions & 2 deletions mods/creative/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: creative
==========================
Minetest Game mod: creative
===========================

Implements creative mode.

Expand Down
2 changes: 1 addition & 1 deletion mods/default/README.txt
@@ -1,4 +1,4 @@
Minetest 0.4 mod: default
Minetest Game mod: default
==========================

License of source code:
Expand Down
4 changes: 2 additions & 2 deletions mods/doors/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: doors
=======================
Minetest Game mod: doors
========================
version: 1.3

License of source code:
Expand Down
2 changes: 1 addition & 1 deletion mods/dye/README.txt
@@ -1,4 +1,4 @@
Minetest 0.4 mod: dye
Minetest Game mod: dye
======================

See init.lua for documentation.
Expand Down
6 changes: 3 additions & 3 deletions mods/farming/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: farming
=========================
Minetest Game mod: farming
==========================

License of source code:
-----------------------
Expand Down Expand Up @@ -45,4 +45,4 @@ Created by Gambit (License: WTFPL):
farming_cotton_*.png
farming_flour.png
farming_cotton_seed.png
farming_wheat_seed.png
farming_wheat_seed.png
4 changes: 2 additions & 2 deletions mods/fire/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: fire
======================
Minetest Game mod: fire
=======================

License of source code:
-----------------------
Expand Down
4 changes: 2 additions & 2 deletions mods/flowers/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: flowers
=========================
Minetest Game mod: flowers
==========================

License of source code:
-----------------------
Expand Down
6 changes: 3 additions & 3 deletions mods/screwdriver/readme.txt
@@ -1,5 +1,5 @@
Minetest mod: screwdriver
=========================
Minetest Game mod: screwdriver
==============================

License of source code:
-----------------------
Expand All @@ -18,4 +18,4 @@ Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
http://creativecommons.org/licenses/by-sa/3.0/

Created by Gambit (WTFPL):
screwdriver.png
screwdriver.png
2 changes: 1 addition & 1 deletion mods/stairs/README.txt
@@ -1,4 +1,4 @@
Minetest 0.4 mod: stairs
Minetest Game mod: stairs
=========================

License of source code:
Expand Down
3 changes: 2 additions & 1 deletion mods/tnt/README.txt
@@ -1,4 +1,5 @@
=== TNT mod for Minetest ===
Minetest Game mod: tnt
======================
by PilzAdam and ShadowNinja

Introduction:
Expand Down
2 changes: 1 addition & 1 deletion mods/vessels/README.txt
@@ -1,4 +1,4 @@
Minetest 0.4 mod: vessels
Minetest Game mod: vessels
==========================

Crafts
Expand Down
4 changes: 2 additions & 2 deletions mods/wool/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4 mod: wool
======================
Minetest Game mod: wool
=======================

Mostly backward-compatible with jordach's 16-color wool mod.

Expand Down
4 changes: 2 additions & 2 deletions mods/xpanes/README.txt
@@ -1,5 +1,5 @@
Minetest 0.4.x mod: xpanes
==========================
Minetest Game mod: xpanes
=========================

License:
--------
Expand Down

0 comments on commit 8e51f31

Please sign in to comment.