Merge pull request 'Release 0.79' (#2651) from release_0.79 into master

Reviewed-on: MineClone2/MineClone2#2651
Reviewed-by: PrairieWind <prairie.astronomer1@gmail.com>
This commit is contained in:
cora 2022-09-14 21:49:22 +00:00
commit 24ed9904e7
4 changed files with 76 additions and 69 deletions

View File

@ -2,7 +2,7 @@
So you want to contribute to MineClone2? So you want to contribute to MineClone2?
Wow, thank you! :-) Wow, thank you! :-)
MineClone2 is maintained by Nicu and Fleckenstein. If you have any MineClone2 is maintained by Nicu and Cora. If you have any
problems or questions, contact us (See Links section below). problems or questions, contact us (See Links section below).
You can help with MineClone2's development in many different ways, You can help with MineClone2's development in many different ways,
@ -11,18 +11,9 @@ whether you're a programmer or not.
## MineClone2's development target is to... ## MineClone2's development target is to...
- Crucially, create a stable, moddable, free/libre clone of Minecraft - Crucially, create a stable, moddable, free/libre clone of Minecraft
based on the Minetest engine with polished features, usable in both based on the Minetest engine with polished features, usable in both
singleplayer and multiplayer. Currently, most of **Minecraft Java singleplayer and multiplayer. Currently, a lot of Minecraft features
Edition 1.12.2** features are already implemented and polishing existing are already implemented.
features are prioritized over new feature requests. Polishing existing features is always welcome.
- With lessened priority yet strictly, implement features targetting
**Minecraft version 1.17 + OptiFine** (OptiFine only as far as supported
by the Minetest Engine). This means features in parity with the listed
Minecraft experiences are prioritized over those that don't fulfill this
scope.
- Optionally, create a performant experience that will run relatively
well on really low spec computers. Unfortunately, due to Minecraft's
mechanisms and Minetest engine's limitations along with a very small
playerbase on low spec computers, optimizations are hard to investigate.
## Links ## Links
* [Mesehub](https://git.minetest.land/MineClone2/MineClone2) * [Mesehub](https://git.minetest.land/MineClone2/MineClone2)
@ -45,8 +36,10 @@ referenced frequently because of its usefulness. As such, it is valuable
in learning how git works and its terminology. It can also help you in learning how git works and its terminology. It can also help you
keeping your game updated, and easily test pull requests. keeping your game updated, and easily test pull requests.
## How you can help as a non-programmer Look at our wiki for some concrete guides:
https://git.minetest.land/MineClone2/MineClone2/wiki/
## How you can help as a non-programmer
As someone who does not know how to write programs in Lua or does not As someone who does not know how to write programs in Lua or does not
know how to use the Minetest API, you can still help us out a lot. For know how to use the Minetest API, you can still help us out a lot. For
example, by opening an issue in the example, by opening an issue in the
@ -58,12 +51,10 @@ you can report a bug or request a feature.
discussion. discussion.
* Choose a descriptive title (e.g. not just "crash", "bug" or "question" * Choose a descriptive title (e.g. not just "crash", "bug" or "question"
). ).
* Please write in plain, understandable English. It will be easier to
communicate.
* Please start the issue title with a capital letter.
* Always check the currently opened issues before creating a new one. * Always check the currently opened issues before creating a new one.
Don't report bugs that have already been reported or request features Try not to report bugs that have already been reported or request features
that already have been requested. that already have been requested. This can often be ambiguous though.
If in doubt open an issue!
* If you know about Minetest's inner workings, please think about * If you know about Minetest's inner workings, please think about
whether the bug / the feature that you are reporting / requesting is whether the bug / the feature that you are reporting / requesting is
actually an issue with Minetest itself, and if it is, head to the actually an issue with Minetest itself, and if it is, head to the
@ -73,6 +64,9 @@ instead.
an issue, feel free to ask on the Discord / Matrix server or the IRC an issue, feel free to ask on the Discord / Matrix server or the IRC
channel. channel.
The link to the mesehub registration page is: https://git.minetest.land/user/sign_up
(It appears to sometimes get lost on the page itsself)
### Reporting bugs ### Reporting bugs
* A bug is an unintended behavior or, in the worst case, a crash. * A bug is an unintended behavior or, in the worst case, a crash.
However, it is not a bug if you believe something is missing in the However, it is not a bug if you believe something is missing in the
@ -111,23 +105,28 @@ would report issues will pull requests similar to when you were
reporting bugs that are the mainline (See Reporting bugs section). You reporting bugs that are the mainline (See Reporting bugs section). You
can find currently open pull requests here: can find currently open pull requests here:
<https://git.minetest.land/MineClone2/MineClone2/pulls>. Note that pull <https://git.minetest.land/MineClone2/MineClone2/pulls>. Note that pull
requests that start with a `WIP:` are not done yet, and therefore might requests that start with a `WIP:` are not done yet and therefore could
not work, so it's not very useful to try them out yet. still undergo substantial change. Testing these is still helpful however
because that is the reason developers put them up as WIP so other people
can have a look at the PR.
### Contributing assets ### Contributing assets
Due to license problems, MineClone2 unfortunately cannot use Due to license problems, MineClone2 cannot use Minecraft's assets,
Minecraft's assets, therefore we are always looking for asset therefore we are always looking for asset contributions.
contributions. To contribute assets, it can be useful to learn git
basics and read the section for Programmers of this document, however To contribute assets, it can be useful to learn git basics and read
this is not required. It's also a good idea to join the Discord server the section for Programmers of this document, however this is not required.
It's also a good idea to join the Discord server
(or alternatively IRC or Matrix). (or alternatively IRC or Matrix).
#### Textures #### Textures
For textures we use the Pixel Perfection texture pack. This is mostly For textures we use the Pixel Perfection texture pack. For older Minecraft
enough; however in some cases - e.g. for newer Minecraft features, it's features that is mostly enough but a lot of the newer textures in it are
useful to have texture artists around. If you want to make such copies or slight modifications of the original MC textures so great caution
contributions, join our Discord server. Demands for textures will be needs to be taken when using any textures coming from Minecraft texture
communicated there. packs.
If you want to make such contributions, join our Discord server. Demands
for textures will be communicated there.
#### Sounds #### Sounds
MineClone2 currently does not have a consistent way to handle sounds. MineClone2 currently does not have a consistent way to handle sounds.
@ -251,16 +250,25 @@ of the results)
* [Official Minecraft Wiki](https://minecraft.fandom.com/wiki/Minecraft_Wiki) * [Official Minecraft Wiki](https://minecraft.fandom.com/wiki/Minecraft_Wiki)
(Include a link to the specific page you used) (Include a link to the specific page you used)
### Stick to our guidelines ### Guidelines
#### Git Guidelines #### Git Guidelines
* We use merge rather than rebase or squash merge * Pushing to master is disabled - don't even try it.
* We don't use git submodules. * Every change is tracked as a PR.
* Your commit names should be relatively descriptive, e.g. when saying * All but the tiniest changes require at least one approval from a Developer
"Fix #issueid", the commit message should also contain the title of the * To update branches we use rebase not merge (so we don't end up with
issue. excessive git bureaucracy commits in master)
* Try to keep your commits as atomic as possible (advise, but completely * We use merge to add the commits from a PR/branch to master
optional) * Submodules should only be used if a) upstream is highly reliable and
b) it is 100% certain that no mcl2 specific changes to the code will be
needed (this has never been the case before, hence mcl2 is submodule free so far)
* Commit messages should be descriptive and never contain mcl2 specific
issueids - there are other projects who might use commits from mcl2 and
it will confuse their issue trackers.
* Try to group your submissions best as you can:
* Try to keep your PRs small: In some cases things reasonably be can't
split up but in general multiple small PRs are better than a big one.
* Similarly multiple small commits are better than a giant one. (use git commit -p)
#### Code Guidelines #### Code Guidelines
* Each mod must provide `mod.conf`. * Each mod must provide `mod.conf`.
@ -343,36 +351,23 @@ Active and trusted contributors are often granted write access to the
MineClone2 repository. MineClone2 repository.
#### Developer responsibilities #### Developer responsibilities
- You should not push things directly to - If you have developer privileges you can just open a new branch in the
MineClone2 master - rather, do your work on a branch on your private mcl2 repository (which is preferred). From that you create a pull request.
repository, then create a pull request. This way other people can review This way other people can review your changes and make sure they work
your changes and make sure they work before they get merged. before they get merged.
- Merge PRs only when they have recieved the necessary feedback and have - If you do not (yet) have developer privs you do your work on a branch
been tested by at least two different people (including the author of on your private repository e.g. using the "fork" function on mesehub.
the pull request), to avoid crashes or the introduction of new bugs. - Any developer is welcome to review, test and merge PRs. A PR needs
- You may also be assigned to issues or pull at least one approval (by someone else than the author) but the maintainers
requests as a developer. In this case it is your responsibility to fix are usually relatively quick to react to new submissions.
the issue / review and merge the pull request when it is ready. You can
also unassign yourself from the issue / PR if you have no time or don't
want to take care of it for some other reason. After all, everyone is a
volunteer and we can't expect you to do work that you are not interested
in. **The important thing is that you make sure to inform us if you
won't take care of something that has been assigned to you.**
- Please assign yourself to something that you want to work on to avoid
duplicate work.
- As a developer, it should be easy to reach you about your work. You
should be in at least one of the public MineClone2 discussion rooms -
preferrably Discord, but if you really don't like Discord, Matrix
or IRC are fine too.
### Maintainer status ### Maintainer status
Maintainers carry the main responsibility for the project. Maintainers carry the main responsibility for the project.
#### Maintainer responsibilities #### Maintainer responsibilities
- Making sure issues are addressed and pull requests are reviewed and - Making sure issues are addressed and pull requests are reviewed and
merged, by assigning either themselves or Developers to issues / PRs merged.
- Making releases - Making releases
- Making sure guidelines are kept
- Making project decisions based on community feedback - Making project decisions based on community feedback
- Granting/revoking developer access - Granting/revoking developer access
- Enforcing the code of conduct (See CODE_OF_CONDUCT.md) - Enforcing the code of conduct (See CODE_OF_CONDUCT.md)
@ -380,8 +375,8 @@ merged, by assigning either themselves or Developers to issues / PRs
- Resolving conflicts and problems within the community - Resolving conflicts and problems within the community
#### Current maintainers #### Current maintainers
* Fleckenstein - responsible for gameplay review, publishing releases, * Cora - responsible for gameplay review, publishing releases,
technical guidelines and issue/PR delegation technical guidelines
* Nicu - responsible for community related issues * Nicu - responsible for community related issues
#### Release process #### Release process

View File

@ -29,9 +29,10 @@
* kabou * kabou
* rudzik8 * rudzik8
* chmodsayshello * chmodsayshello
* PrarieWind * PrairieWind
* RandomLegoBrick * RandomLegoBrick
* SumianVoice * SumianVoice
* MrRar
## Contributors ## Contributors
* Laurent Rocher * Laurent Rocher
@ -82,6 +83,8 @@
* mrminer * mrminer
* Thunder1035 * Thunder1035
* opfromthestart * opfromthestart
* snowyu
* FaceDeer
## MineClone5 ## MineClone5
* kay27 * kay27
@ -91,7 +94,7 @@
* j45 * j45
* chmodsayshello * chmodsayshello
* 3raven * 3raven
* PrarieWind * PrairieWind
* Gustavo1 * Gustavo1
* CableGuy67 * CableGuy67
* MrRar * MrRar
@ -132,6 +135,7 @@
* 4Evergreen4 * 4Evergreen4
* jordan4ibanez * jordan4ibanez
* paramat * paramat
* cora
## 3D Models ## 3D Models
* 22i * 22i
@ -161,6 +165,8 @@
* Marcin Serwin * Marcin Serwin
* Pepebotella * Pepebotella
* Emojigit * Emojigit
* snowyu
* 3raven
## Funders ## Funders
* 40W * 40W

View File

@ -2,7 +2,7 @@
An unofficial Minecraft-like game for Minetest. Forked from MineClone by davedevils. An unofficial Minecraft-like game for Minetest. Forked from MineClone by davedevils.
Developed by many people. Not developed or endorsed by Mojang AB. Developed by many people. Not developed or endorsed by Mojang AB.
Version: 0.79 (in development) Version: 0.79
### Gameplay ### Gameplay
You start in a randomly-generated world made entirely of cubes. You can explore You start in a randomly-generated world made entirely of cubes. You can explore

View File

@ -30,9 +30,10 @@ return {
"kabou", "kabou",
"rudzik8", "rudzik8",
"chmodsayshello", "chmodsayshello",
"PrarieWind", "PrairieWind",
"RandomLegoBrick", "RandomLegoBrick",
"SumianVoice", "SumianVoice",
"MrRar",
}}, }},
{S("Contributors"), 0x52FF00, { {S("Contributors"), 0x52FF00, {
"Laurent Rocher", "Laurent Rocher",
@ -83,6 +84,8 @@ return {
"mrminer", "mrminer",
"Thunder1035", "Thunder1035",
"opfromthestart", "opfromthestart",
"snowyu",
"FaceDeer",
}}, }},
{S("MineClone5"), 0xA60014, { {S("MineClone5"), 0xA60014, {
"kay27", "kay27",
@ -92,7 +95,7 @@ return {
"j45", "j45",
"chmodsayshello", "chmodsayshello",
"3raven", "3raven",
"PrarieWind", "PrairieWind",
"Gustavo1", "Gustavo1",
"CableGuy67", "CableGuy67",
"MrRar", "MrRar",
@ -133,6 +136,7 @@ return {
"4Evergreen4", "4Evergreen4",
"jordan4ibanez", "jordan4ibanez",
"paramat", "paramat",
"cora",
}}, }},
{S("3D Models"), 0x0019FF, { {S("3D Models"), 0x0019FF, {
"22i", "22i",
@ -162,6 +166,8 @@ return {
"Marcin Serwin", "Marcin Serwin",
"Pepebotella", "Pepebotella",
"Emojigit", "Emojigit",
"snowyu",
"3raven",
}}, }},
{S("Funders"), 0xF7FF00, { {S("Funders"), 0xF7FF00, {
"40W", "40W",