Add spaces after #, make the commands monospaced
parent
aa3b3421d5
commit
a609639585
23
MODELS.md
23
MODELS.md
|
@ -1,13 +1,14 @@
|
||||||
#Models in Minetest/Mineclone2
|
# Models in Minetest/Mineclone2
|
||||||
|
|
||||||
Models are an important part of all entities & unique nodes in Mineclone2. They provide a 3 dimensional map of an object for which textures are then applied to. This document is for modders, it quickly highlights some important information for the software needed to open models in Mineclone2.
|
Models are an important part of all entities & unique nodes in Mineclone2. They provide a 3 dimensional map of an object for which textures are then applied to. This document is for modders, it quickly highlights some important information for the software needed to open models in Mineclone2.
|
||||||
|
|
||||||
## Minetest Wiki
|
## Minetest Wiki
|
||||||
|
|
||||||
For more detailed information on actually using blender to create and modify models for Minetest/Mineclone2, please visit the Minetest wiki's page on using Blender [Here](https://wiki.minetest.net/Using_Blender)
|
For more detailed information on actually using blender to create and modify models for Minetest/Mineclone2, please visit the Minetest wiki's page on using Blender [Here](https://wiki.minetest.net/Using_Blender)
|
||||||
|
|
||||||
##Recommended software
|
## Recommended software
|
||||||
|
|
||||||
###Blender
|
### Blender
|
||||||
|
|
||||||
Blender is a very popular and free modeling software supported on Windows, MacOS, and most Linux distributions. It is recommended to use Blender to create and modify 3D models within the minetest engine.
|
Blender is a very popular and free modeling software supported on Windows, MacOS, and most Linux distributions. It is recommended to use Blender to create and modify 3D models within the minetest engine.
|
||||||
|
|
||||||
|
@ -19,14 +20,16 @@ Blitz 3D (.b3d) Is one of the main animated model formats used for entities in t
|
||||||
|
|
||||||
The most up to date version of this Blender plugin can be downloaded [Here](https://github.com/GreenXenith/io_scene_b3d/releases/tag/f189786)
|
The most up to date version of this Blender plugin can be downloaded [Here](https://github.com/GreenXenith/io_scene_b3d/releases/tag/f189786)
|
||||||
|
|
||||||
##Types of model formats
|
## Types of model formats
|
||||||
|
|
||||||
|
### Animated, skinned models
|
||||||
|
|
||||||
###Animated, skinned models
|
|
||||||
* Blitz 3D files (.b3d)
|
* Blitz 3D files (.b3d)
|
||||||
|
|
||||||
* Microsoft DirectX (.x) (binary & text, compression is not supported)
|
* Microsoft DirectX (.x) (binary & text, compression is not supported)
|
||||||
|
|
||||||
###Static meshes
|
### Static meshes
|
||||||
|
|
||||||
* Wavefront OBJ (.obj)
|
* Wavefront OBJ (.obj)
|
||||||
|
|
||||||
Note: The sometimes accompanying .mtl files are not supported and can safely be deleted.
|
Note: The sometimes accompanying .mtl files are not supported and can safely be deleted.
|
||||||
|
@ -45,16 +48,18 @@ Note: Do not use .b3d and .x files for static meshes at the moment, Minetest cur
|
||||||
|
|
||||||
Note: Any formats not mentioned above but known to work in the past were removed in 5.5.0 and aren't supported anymore.
|
Note: Any formats not mentioned above but known to work in the past were removed in 5.5.0 and aren't supported anymore.
|
||||||
|
|
||||||
##Pros & Cons of .b3d vs .x
|
## Pros & Cons of .b3d vs .x
|
||||||
|
|
||||||
|
### B3D
|
||||||
|
|
||||||
###B3D
|
|
||||||
* [+] Binary format means a small size
|
* [+] Binary format means a small size
|
||||||
|
|
||||||
* [-] Difficult to postprocess after exporting
|
* [-] Difficult to postprocess after exporting
|
||||||
|
|
||||||
* [-] Difficult to debug problems
|
* [-] Difficult to debug problems
|
||||||
|
|
||||||
###X (text version)
|
### X (text version)
|
||||||
|
|
||||||
* [+] Can be parsed easily with lua scripts
|
* [+] Can be parsed easily with lua scripts
|
||||||
|
|
||||||
* [+] Can be easily generated by scripts
|
* [+] Can be easily generated by scripts
|
||||||
|
|
18
RELEASE.md
18
RELEASE.md
|
@ -1,10 +1,11 @@
|
||||||
### Standard Release
|
### Standard Release
|
||||||
|
|
||||||
#File to document release steps with a view to evolving into a script
|
# File to document release steps with a view to evolving into a script
|
||||||
|
|
||||||
#Update CREDITS.md
|
# Update CREDITS.md
|
||||||
#Update version in game.conf
|
# Update version in game.conf
|
||||||
|
|
||||||
|
```
|
||||||
lua tools/generate_ingame_credits.lua
|
lua tools/generate_ingame_credits.lua
|
||||||
|
|
||||||
git add CREDITS.md
|
git add CREDITS.md
|
||||||
|
@ -18,10 +19,11 @@ git commit -m "Pre-release update credits and set version 0.83.0"
|
||||||
git tag 0.83.0
|
git tag 0.83.0
|
||||||
|
|
||||||
git push origin 0.83.0
|
git push origin 0.83.0
|
||||||
|
```
|
||||||
|
|
||||||
#Update version in game.conf to the next version with -SNAPSHOT suffix
|
# Update version in game.conf to the next version with -SNAPSHOT suffix
|
||||||
|
|
||||||
git commit -m "Post-release set version 0.84.0-SNAPSHOT"
|
`git commit -m "Post-release set version 0.84.0-SNAPSHOT"`
|
||||||
|
|
||||||
### Hotfix Release
|
### Hotfix Release
|
||||||
|
|
||||||
|
@ -32,15 +34,17 @@ To mitigate this, you just release the last release, and the relevant bug fix. F
|
||||||
|
|
||||||
* Create release branch from the last release tag, push it:
|
* Create release branch from the last release tag, push it:
|
||||||
|
|
||||||
|
```
|
||||||
git checkout -b release/0.82.1 0.82.0
|
git checkout -b release/0.82.1 0.82.0
|
||||||
|
|
||||||
git push origin release/0.82.1
|
git push origin release/0.82.1
|
||||||
|
```
|
||||||
|
|
||||||
##### Prepare feature branch and fix
|
##### Prepare feature branch and fix
|
||||||
|
|
||||||
* Create feature branch from that release branch (can review it to check only fix is there, nothing else, and use to also merge into master separately)
|
* Create feature branch from that release branch (can review it to check only fix is there, nothing else, and use to also merge into master separately)
|
||||||
|
|
||||||
git checkout -b hotfix_bug_1_branch
|
`git checkout -b hotfix_bug_1_branch`
|
||||||
|
|
||||||
* Fix crash/serious bug and commit
|
* Fix crash/serious bug and commit
|
||||||
* Push branch and create pr to the release and also the master branch (Do not rebase, to reduce merge conflict risk. Do not delete after first merge or it needs to be repushed)
|
* Push branch and create pr to the release and also the master branch (Do not rebase, to reduce merge conflict risk. Do not delete after first merge or it needs to be repushed)
|
||||||
|
@ -53,11 +57,13 @@ git checkout -b hotfix_bug_1_branch
|
||||||
|
|
||||||
* Tag it, push tag and branch:
|
* Tag it, push tag and branch:
|
||||||
|
|
||||||
|
```
|
||||||
git tag 0.82.1
|
git tag 0.82.1
|
||||||
|
|
||||||
git push origin 0.82.1
|
git push origin 0.82.1
|
||||||
|
|
||||||
git push origin release/0.82.1
|
git push origin release/0.82.1
|
||||||
|
```
|
||||||
|
|
||||||
Note: If you have to do more than 1 hotfix release, can do it on the same release branch.
|
Note: If you have to do more than 1 hotfix release, can do it on the same release branch.
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue