Compare commits
2 Commits
master
...
doc_update
Author | SHA1 | Date |
---|---|---|
the-real-herowl | a70a0440cd | |
the-real-herowl | e155cdc22f |
12
API.md
|
@ -1,10 +1,10 @@
|
||||||
# API
|
# API
|
||||||
## Groups
|
## Groups
|
||||||
MineClone 2 makes very extensive use of groups. Making sure your items and objects have the correct group memberships is very important.
|
VoxeLibre makes very extensive use of groups. Making sure your items and objects have the correct group memberships is very important.
|
||||||
Groups are explained in `GROUPS.md`.
|
Groups are explained in `GROUPS.md`.
|
||||||
|
|
||||||
## Mod naming convention
|
## Mod naming convention
|
||||||
Mods mods in MineClone 2 follow a simple naming convention: Mods with the prefix “`mcl_`” are specific to MineClone 2, although they may be based on an existing standalone. Mods which lack this prefix are *usually* verbatim copies of a standalone mod. Some modifications may still have been applied, but the APIs are held compatible.
|
Mods mods in VoxeLibre follow a simple naming convention: Mods with the prefix "`vl_`" and “`mcl_`” are specific to VoxeLibre (formerly known as MineClone2), although they may be based on an existing standalone. Mods which lack this prefix are *usually* verbatim copies of a standalone mod. Some modifications may still have been applied, but the APIs are held compatible.
|
||||||
|
|
||||||
## Adding items
|
## Adding items
|
||||||
### Special fields
|
### Special fields
|
||||||
|
@ -31,7 +31,7 @@ All nodes can have these fields:
|
||||||
Use the `mcl_sounds` mod for the sounds.
|
Use the `mcl_sounds` mod for the sounds.
|
||||||
|
|
||||||
## APIs
|
## APIs
|
||||||
A lot of things are possible by using one of the APIs in the mods. Note that not all APIs are documented yet, but it is planned. The following APIs should be more or less stable but keep in mind that MineClone 2 is still unfinished. All directory names are relative to `mods/`
|
A lot of things are possible by using one of the APIs in the mods. Many of them are documented in `API.md` files located in the directories of the specific mods. Some use `.txt` files or have some documentation in the comments along the code. Note that not all APIs are documented yet, but it is planned. The following APIs should be more or less stable but keep in mind that MineClone 2 is still unfinished. All directory names are relative to `mods/`
|
||||||
|
|
||||||
### Items
|
### Items
|
||||||
* Doors: `ITEMS/mcl_doors`
|
* Doors: `ITEMS/mcl_doors`
|
||||||
|
@ -46,8 +46,7 @@ A lot of things are possible by using one of the APIs in the mods. Note that not
|
||||||
### Mobs
|
### Mobs
|
||||||
* Mobs: `ENTITIES/mcl_mobs`
|
* Mobs: `ENTITIES/mcl_mobs`
|
||||||
|
|
||||||
MineClone 2 uses its own mobs framework, called “Mobs Redo: MineClone 2 Edition” or “MRM” for short.
|
VoxeLibre uses its own mobs framework, which is a fork of Mobs Redo [`mobs`] by TenPlus1.
|
||||||
This is a fork of Mobs Redo [`mobs`] by TenPlus1.
|
|
||||||
|
|
||||||
You can add your own mobs, spawn eggs and spawning rules with this mod.
|
You can add your own mobs, spawn eggs and spawning rules with this mod.
|
||||||
API documnetation is included in `ENTITIES/mcl_mobs/api.txt`.
|
API documnetation is included in `ENTITIES/mcl_mobs/api.txt`.
|
||||||
|
@ -68,6 +67,7 @@ chances are good that it works out of the box.
|
||||||
|
|
||||||
### Utility APIs
|
### Utility APIs
|
||||||
* Change player physics: `PLAYER/playerphysics`
|
* Change player physics: `PLAYER/playerphysics`
|
||||||
|
* Change player FOV: `PLAYER/mcl_fovapi`
|
||||||
* Select random treasures: `CORE/mcl_loot`
|
* Select random treasures: `CORE/mcl_loot`
|
||||||
* Get flowing direction of liquids: `CORE/flowlib`
|
* Get flowing direction of liquids: `CORE/flowlib`
|
||||||
* `on_walk_over` callback for nodes: `CORE/walkover`
|
* `on_walk_over` callback for nodes: `CORE/walkover`
|
||||||
|
@ -77,7 +77,7 @@ chances are good that it works out of the box.
|
||||||
* Flowers and flower pots
|
* Flowers and flower pots
|
||||||
|
|
||||||
### Unstable APIs
|
### Unstable APIs
|
||||||
The following APIs may be subject to change in future. You could already use these APIs but there will probably be breaking changes in the future, or the API is not as fleshed out as it should be. Use at your own risk!
|
The following APIs may be subject to change in the future. You could already use these APIs but there will probably be breaking changes in the future, or the API is not as fleshed out as it should be. Use at your own risk!
|
||||||
|
|
||||||
* Panes (like glass panes and iron bars): `ITEMS/xpanes`
|
* Panes (like glass panes and iron bars): `ITEMS/xpanes`
|
||||||
* `_on_ignite` callback: `ITEMS/mcl_fire`
|
* `_on_ignite` callback: `ITEMS/mcl_fire`
|
||||||
|
|
|
@ -1,21 +1,21 @@
|
||||||
# Contributing to MineClone2
|
# Contributing to VoxeLibre
|
||||||
So you want to contribute to MineClone2?
|
So you want to contribute to VoxeLibre?
|
||||||
Wow, thank you! :-)
|
Wow, thank you! :-)
|
||||||
|
|
||||||
MineClone2 is maintained by AncientMariner and Nicu. If you have any
|
VoxeLibre is maintained by AncientMariner and Herowl. If you have any
|
||||||
problems or questions, contact us on Discord/Matrix (See Links section below).
|
problems or questions, contact us on Discord/Matrix (See Links section below).
|
||||||
|
|
||||||
You can help with MineClone2's development in many different ways,
|
You can help with VoxeLibre's development in many different ways,
|
||||||
whether you're a programmer or not.
|
whether you're a programmer or not.
|
||||||
|
|
||||||
## MineClone2's development target is to...
|
## VoxeLibre's development target is to...
|
||||||
- Create a stable, peformant, moddable, free/libre game based on Minecraft
|
- Create a stable, peformant, moddable, free/libre game inspired by Minecraft
|
||||||
using the Minetest engine, usable in both singleplayer and multiplayer.
|
using the Minetest engine, usable in both singleplayer and multiplayer.
|
||||||
- Currently, a lot of features are already implemented.
|
- Currently, a lot of features are already implemented.
|
||||||
Polishing existing features is always welcome.
|
Polishing existing features is always welcome.
|
||||||
|
|
||||||
## Links
|
## Links
|
||||||
* [Mesehub](https://git.minetest.land/MineClone2/MineClone2)
|
* [Mesehub](https://git.minetest.land/VoxeLibre/VoxeLibre)
|
||||||
* [Discord](https://discord.gg/xE4z8EEpDC)
|
* [Discord](https://discord.gg/xE4z8EEpDC)
|
||||||
* [YouTube](https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A)
|
* [YouTube](https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A)
|
||||||
* [IRC](https://web.libera.chat/#mineclone2)
|
* [IRC](https://web.libera.chat/#mineclone2)
|
||||||
|
@ -26,23 +26,23 @@ Polishing existing features is always welcome.
|
||||||
* [OpenCollective](https://opencollective.com/mineclone2)
|
* [OpenCollective](https://opencollective.com/mineclone2)
|
||||||
|
|
||||||
## Using git
|
## Using git
|
||||||
MineClone2 is developed using the version control system
|
VoxeLibre is developed using the version control system
|
||||||
[git](https://git-scm.com/). If you want to contribute code to the
|
[git](https://git-scm.com/). If you want to contribute code to the
|
||||||
project, it is **highly recommended** that you learn the git basics.
|
project, it is **highly recommended** that you learn the git basics.
|
||||||
For non-programmers and people who do not plan to contribute code to
|
For non-programmers and people who do not plan to contribute code to
|
||||||
MineClone2, git is not required. However, git is a tool that will be
|
VoxeLibre, git is not required. However, git is a tool that will be
|
||||||
referenced frequently because of its usefulness. As such, it is valuable
|
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.
|
||||||
|
|
||||||
Look at our wiki for some concrete guides:
|
Look at our wiki for some concrete guides:
|
||||||
https://git.minetest.land/MineClone2/MineClone2/wiki/
|
https://git.minetest.land/VoxeLibre/VoxeLibre/wiki/
|
||||||
|
|
||||||
## How you can help as a non-programmer
|
## 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
|
||||||
[Issue tracker](https://git.minetest.land/MineClone2/MineClone2/issues),
|
[Issue tracker](https://git.minetest.land/VoxeLibre/VoxeLibre/issues),
|
||||||
you can report a bug or request a feature.
|
you can report a bug or request a feature.
|
||||||
|
|
||||||
### Rules about both bugs and feature requests
|
### Rules about both bugs and feature requests
|
||||||
|
@ -75,7 +75,7 @@ in singleplayer, post a screenshot of the message that Minetest showed
|
||||||
when the crash happened (or copy the message into your issue). If you
|
when the crash happened (or copy the message into your issue). If you
|
||||||
are a server admin, you can find error messages in the log file of the
|
are a server admin, you can find error messages in the log file of the
|
||||||
server.
|
server.
|
||||||
* Tell us which MineClone2 and Minetest versions you are using (from Minetest 5.7 type /ver, for previous versions, check the game.conf or README.md file).
|
* Tell us which VoxeLibre and Minetest versions you are using (from Minetest 5.7 type /ver, for previous versions, check the game.conf or README.md file).
|
||||||
* Tell us how to reproduce the problem: What you were doing to trigger
|
* Tell us how to reproduce the problem: What you were doing to trigger
|
||||||
the bug, e.g. before the crash happened or what causes the faulty
|
the bug, e.g. before the crash happened or what causes the faulty
|
||||||
behavior.
|
behavior.
|
||||||
|
@ -84,14 +84,14 @@ behavior.
|
||||||
* Ensure the requested feature fulfills our development targets and
|
* Ensure the requested feature fulfills our development targets and
|
||||||
goals.
|
goals.
|
||||||
* Begging or excessive attention seeking does not help us in the
|
* Begging or excessive attention seeking does not help us in the
|
||||||
slightest, and may very well disrupt MineClone2 development. It's better
|
slightest, and may very well disrupt VoxeLibre development. It's better
|
||||||
to put that energy into helping or researching the feature in question.
|
to put that energy into helping or researching the feature in question.
|
||||||
After all, we're just volunteers working on our spare time.
|
After all, we're just volunteers working on our spare time.
|
||||||
* Ensure the requested feature has not been implemented in MineClone2
|
* Ensure the requested feature has not been implemented in VoxeLibre
|
||||||
latest or development versions.
|
latest or development versions.
|
||||||
|
|
||||||
### Testing code
|
### Testing code
|
||||||
If you want to help us with speeding up MineClone2 development and
|
If you want to help us with speeding up VoxeLibre development and
|
||||||
making the game more stable, a great way to do that is by testing out
|
making the game more stable, a great way to do that is by testing out
|
||||||
new features from contributors. For most new things that get into the
|
new features from contributors. For most new things that get into the
|
||||||
game, a pull request is created. A pull request is essentially a
|
game, a pull request is created. A pull request is essentially a
|
||||||
|
@ -103,14 +103,16 @@ tell us if the code works as expected without any issues. Ideally, you
|
||||||
would report issues will pull requests similar to when you were
|
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/VoxeLibre/VoxeLibre/pulls>. Note that pull
|
||||||
requests that start with a `WIP:` are not done yet and therefore could
|
requests that start with a `WIP:` are not done yet and therefore could
|
||||||
still undergo substantial change. Testing these is still helpful however
|
still undergo substantial change. Testing these is still helpful however
|
||||||
because that is the reason developers put them up as WIP so other people
|
because that is the reason developers put them up as WIP so other people
|
||||||
can have a look at the PR.
|
can have a look at the PR. The wiki has an article with instructions
|
||||||
|
on how to test Pull Requests:
|
||||||
|
<https://git.minetest.land/VoxeLibre/VoxeLibre/wiki/Testing-Pull-Requests>.
|
||||||
|
|
||||||
### Contributing assets
|
### Contributing assets
|
||||||
Due to license problems, MineClone2 cannot use Minecraft's assets,
|
Due to license problems, VoxeLibre cannot use Minecraft's assets,
|
||||||
therefore we are always looking for asset contributions.
|
therefore we are always looking for asset contributions.
|
||||||
|
|
||||||
To contribute assets, it can be useful to learn git basics and read
|
To contribute assets, it can be useful to learn git basics and read
|
||||||
|
@ -128,9 +130,9 @@ If you want to make such contributions, join our Discord server. Demands
|
||||||
for textures will be communicated there.
|
for textures will be communicated there.
|
||||||
|
|
||||||
#### Sounds
|
#### Sounds
|
||||||
MineClone2 currently does not have a consistent way to handle sounds.
|
VoxeLibre currently does not have a consistent way to handle sounds.
|
||||||
The sounds in the game come from different sources, like the SnowZone
|
The sounds in the game come from different sources, like the SnowZone
|
||||||
resource pack or minetest_game. Unfortunately, MineClone2 does not play
|
resource pack or minetest_game. Unfortunately, VoxeLibre does not play
|
||||||
a sound in every situation you would get one in Minecraft. Any help with
|
a sound in every situation you would get one in Minecraft. Any help with
|
||||||
sounds is greatly appreciated, however if you add new sounds you should
|
sounds is greatly appreciated, however if you add new sounds you should
|
||||||
probably work together with a programmer, to write the code to actually
|
probably work together with a programmer, to write the code to actually
|
||||||
|
@ -140,7 +142,7 @@ changes made by the contributor. Use the README files in the mod to
|
||||||
communicate this information.
|
communicate this information.
|
||||||
|
|
||||||
#### 3D Models
|
#### 3D Models
|
||||||
Most of the 3D Models in MineClone2 come from
|
Many of the 3D Models in VoxeLibre come from
|
||||||
[22i's repository](https://github.com/22i/minecraft-voxel-blender-models).
|
[22i's repository](https://github.com/22i/minecraft-voxel-blender-models).
|
||||||
Similar to the textures, we need people that can make 3D Models with
|
Similar to the textures, we need people that can make 3D Models with
|
||||||
Blender on demand. Many of the models have to be patched, some new
|
Blender on demand. Many of the models have to be patched, some new
|
||||||
|
@ -154,7 +156,7 @@ also be credited in the Contributors section.
|
||||||
### Contributing Translations
|
### Contributing Translations
|
||||||
|
|
||||||
#### Workflow
|
#### Workflow
|
||||||
To add/update support for your language to MineClone2, you should take
|
To add/update support for your language to VoxeLibre, you should take
|
||||||
the steps documented in the section for Programmers, add/update the
|
the steps documented in the section for Programmers, add/update the
|
||||||
translation files of the mods that you want to update. You can add
|
translation files of the mods that you want to update. You can add
|
||||||
support for all mods, just some of them or only one mod; you can update
|
support for all mods, just some of them or only one mod; you can update
|
||||||
|
@ -178,7 +180,7 @@ If you have commited the results yourself, you will also be credited in
|
||||||
the Contributors section.
|
the Contributors section.
|
||||||
|
|
||||||
### Profiling
|
### Profiling
|
||||||
If you own a server, a great way to help us improve MineClone2's code
|
If you own a server, a great way to help us improve VoxeLibre's code
|
||||||
is by giving us profiler results. Profiler results give us detailed
|
is by giving us profiler results. Profiler results give us detailed
|
||||||
information about the game's performance and let us know places to
|
information about the game's performance and let us know places to
|
||||||
investigate optimization issues. This way we can make the game faster.
|
investigate optimization issues. This way we can make the game faster.
|
||||||
|
@ -214,7 +216,7 @@ OpenCollective Funders are credited in their own section in
|
||||||
they have made their donation Incognito).
|
they have made their donation Incognito).
|
||||||
|
|
||||||
## How you can help as a programmer
|
## How you can help as a programmer
|
||||||
(Almost) all the MineClone2 development is done using pull requests.
|
(Almost) all the VoxeLibre development is done using pull requests.
|
||||||
|
|
||||||
### Recommended workflow
|
### Recommended workflow
|
||||||
* Fork the repository (in case you have not already)
|
* Fork the repository (in case you have not already)
|
||||||
|
@ -237,11 +239,11 @@ is no issue on the topic, open one. If there is an issue, tell us that
|
||||||
you'd like to take care of it, to avoid duplicate work.
|
you'd like to take care of it, to avoid duplicate work.
|
||||||
|
|
||||||
### Don't hesitate to ask for help
|
### Don't hesitate to ask for help
|
||||||
We appreciate any contributing effort to MineClone2. If you are a
|
We appreciate any contributing effort to VoxeLibre. If you are a
|
||||||
relatively new programmer, you can reach us on Discord, Matrix or IRC
|
relatively new programmer, you can reach us on Discord, Matrix or IRC
|
||||||
for questions about git, Lua, Minetest API, MineClone2 codebase or
|
for questions about git, Lua, Minetest API, VoxeLibre codebase or
|
||||||
anything related to MineClone2. We can help you avoid writing code that
|
anything related to VoxeLibre. We can help you avoid writing code that
|
||||||
would be deemed inadequate, or help you become familiar with MineClone2
|
would be deemed inadequate, or help you become familiar with VoxeLibre
|
||||||
better, or assist you use development tools.
|
better, or assist you use development tools.
|
||||||
|
|
||||||
### Maintain your own code, even if already got merged
|
### Maintain your own code, even if already got merged
|
||||||
|
@ -271,8 +273,8 @@ of the results)
|
||||||
excessive git bureaucracy commits in master)
|
excessive git bureaucracy commits in master)
|
||||||
* We use merge to add the commits from a PR/branch to master
|
* We use merge to add the commits from a PR/branch to master
|
||||||
* Submodules should only be used if a) upstream is highly reliable and
|
* 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
|
b) it is 100% certain that no VL specific changes to the code will be
|
||||||
needed (this has never been the case before, hence mcl2 is submodule free so far)
|
needed (this has never been the case before, hence VL is submodule free so far)
|
||||||
* Commit messages should be descriptive
|
* Commit messages should be descriptive
|
||||||
* Try to group your submissions best as you can:
|
* Try to group your submissions best as you can:
|
||||||
* Try to keep your PRs small: In some cases things reasonably be can't
|
* Try to keep your PRs small: In some cases things reasonably be can't
|
||||||
|
@ -357,14 +359,14 @@ end
|
||||||
|
|
||||||
### Developer status
|
### Developer status
|
||||||
Active and trusted contributors are often granted write access to the
|
Active and trusted contributors are often granted write access to the
|
||||||
MineClone2 repository as a contributor. Those that have demonstrated the right
|
VoxeLibre repository as a contributor. Those that have demonstrated the right
|
||||||
technical skills and behaviours may be granted developer access. These are the
|
technical skills and behaviours may be granted developer access. These are the
|
||||||
most trusted contributors who will contribute to ensure coding standards and
|
most trusted contributors who will contribute to ensure coding standards and
|
||||||
processes are followed.
|
processes are followed.
|
||||||
|
|
||||||
#### Developer responsibilities
|
#### Developer responsibilities
|
||||||
- If you have developer/contributor privileges you can just open a new branch
|
- If you have developer/contributor privileges you can just open a new branch
|
||||||
in the mcl2 repository (which is preferred). From that you create a pull request.
|
in the VL repository (which is preferred). From that you create a pull request.
|
||||||
This way other people can review your changes and make sure they work
|
This way other people can review your changes and make sure they work
|
||||||
before they get merged.
|
before they get merged.
|
||||||
- If you do not (yet) have developer privs you do your work on a branch
|
- If you do not (yet) have developer privs you do your work on a branch
|
||||||
|
@ -397,7 +399,7 @@ technical guidelines
|
||||||
#### Release process
|
#### Release process
|
||||||
* Run `tools/generate_ingame_credits.lua` to update the ingame credits
|
* Run `tools/generate_ingame_credits.lua` to update the ingame credits
|
||||||
from `CREDITS.md` and commit the result (if anything changed)
|
from `CREDITS.md` and commit the result (if anything changed)
|
||||||
* Launch MineClone2 to make sure it still runs
|
* Launch VoxeLibre to make sure it still runs
|
||||||
* Update the version number in README.md
|
* Update the version number in README.md
|
||||||
* Use `git tag <version number>` to tag the latest commit with the
|
* Use `git tag <version number>` to tag the latest commit with the
|
||||||
version number
|
version number
|
||||||
|
|
|
@ -25,7 +25,7 @@ The basic digging time groups determine by which tools a node can be dug.
|
||||||
* `handy=1`: Breakable by hand and this node gives it useful drop when dug by hand. All nodes which are breakable by pickaxe, axe, shovel, sword or shears are also automatically breakable by hand, but not neccess
|
* `handy=1`: Breakable by hand and this node gives it useful drop when dug by hand. All nodes which are breakable by pickaxe, axe, shovel, sword or shears are also automatically breakable by hand, but not neccess
|
||||||
* `creative_breakable=1`: Block is breakable by hand in creative mode. This group is implied if the node belongs to any other digging group
|
* `creative_breakable=1`: Block is breakable by hand in creative mode. This group is implied if the node belongs to any other digging group
|
||||||
|
|
||||||
Please read <http://minecraft.gamepedia.com/Breaking> to learn how digging times work in Minecraft, as MineClone 2 is based on the same system.
|
Please read <http://minecraft.gamepedia.com/Breaking> to learn how digging times work in Minecraft, as VoxeLibre is based on the same system.
|
||||||
|
|
||||||
### Groups for interactions
|
### Groups for interactions
|
||||||
|
|
||||||
|
@ -117,7 +117,7 @@ These groups correspond to the Minecraft materials. They classify the block into
|
||||||
* `material_glass=1`: Glass
|
* `material_glass=1`: Glass
|
||||||
|
|
||||||
Currently, these groups are used for the note block.
|
Currently, these groups are used for the note block.
|
||||||
Note that not all Minecraft materials are used so far. More Minecraft materials will lilely only be added when they are needed for a concrete use case.
|
Note that not all Minecraft materials are used so far. More Minecraft materials will likely only be added when they are needed for a concrete use case.
|
||||||
|
|
||||||
### Declarative groups
|
### Declarative groups
|
||||||
These groups are used mostly for informational purposes
|
These groups are used mostly for informational purposes
|
||||||
|
|
|
@ -6,15 +6,15 @@ How to play:
|
||||||
- Navigate to https://www.minetest.net/ to download the client.
|
- Navigate to https://www.minetest.net/ to download the client.
|
||||||
- Once installed, open and select the "Content" tab
|
- Once installed, open and select the "Content" tab
|
||||||
|
|
||||||
#### Install MineClone2 from ContentDB
|
#### Install VoxeLibre from ContentDB
|
||||||
- Click "Browse Online Content" and filter by Games (select "Games" from the dropdown box)
|
- Click "Browse Online Content" and filter by Games (select "Games" from the dropdown box)
|
||||||
- Find "MineClone2" (should be first on the list or on the first page)
|
- Find "VoxeLibre" (should be first on the list or on the first page)
|
||||||
- Click the [+] button next to MineClone2 and wait for download to finish
|
- Click the [+] button next to VoxeLibre and wait for download to finish
|
||||||
- Click "Back to Main Menu"
|
- Click "Back to Main Menu"
|
||||||
|
|
||||||
#### Create new world and play
|
#### Create new world and play
|
||||||
- Click "Start Game" tab
|
- Click "Start Game" tab
|
||||||
- At the bottom click the MineClone2 icon (the 2 dirt with grass blocks)
|
- At the bottom click the VoxeLibre icon (the 2 dirt with grass blocks)
|
||||||
- Click "New", give your world a name
|
- Click "New", give your world a name
|
||||||
- You can leave seed blank or put in a word of your choice
|
- You can leave seed blank or put in a word of your choice
|
||||||
- Select your new world
|
- Select your new world
|
||||||
|
|
14
LEGAL.md
|
@ -1,14 +1,14 @@
|
||||||
# Legal information
|
# Legal information
|
||||||
This is a fan game, not developed or endorsed by Mojang AB.
|
This is a game inspired by Minecraft with unique content.
|
||||||
|
|
||||||
Copying is an act of love. Please copy and share! <3
|
Copying is an act of love. Please copy and share! <3
|
||||||
Here's the detailed legalese for those who need it:
|
Here's the detailed legalese for those who need it:
|
||||||
|
|
||||||
## License of source code
|
## License of source code
|
||||||
MineClone 2 (by Lizzy Fleckenstein, Wuzzy, davedevils and countless others)
|
VoxeLibre (by Lizzy Fleckenstein, Wuzzy, davedevils and countless others)
|
||||||
is an imitation of Minecraft.
|
is inspired by Minecraft.
|
||||||
|
|
||||||
MineClone 2 is free software: you can redistribute it and/or modify
|
VoxeLibre is free software: you can redistribute it and/or modify
|
||||||
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
||||||
the Free Software Foundation, either version 3 of the License, or
|
the Free Software Foundation, either version 3 of the License, or
|
||||||
(at your option) any later version.
|
(at your option) any later version.
|
||||||
|
@ -22,15 +22,15 @@ details.
|
||||||
In the mods you might find in the read-me or license
|
In the mods you might find in the read-me or license
|
||||||
text files a different license. This counts as dual-licensing.
|
text files a different license. This counts as dual-licensing.
|
||||||
You can choose which license applies to you: Either the
|
You can choose which license applies to you: Either the
|
||||||
license of MineClone 2 (GNU GPLv3) or the mod's license.
|
license of VoxeLibre (GNU GPLv3) or the mod's license.
|
||||||
|
|
||||||
MineClone 2 is a direct continuation of the discontinued MineClone
|
VoxeLibre is a direct continuation of the discontinued MineClone
|
||||||
project by davedevils.
|
project by davedevils.
|
||||||
|
|
||||||
Mod credits:
|
Mod credits:
|
||||||
See `README.txt` or `README.md` in each mod directory for information about other authors.
|
See `README.txt` or `README.md` in each mod directory for information about other authors.
|
||||||
For mods that do not have such a file, the license is the source code license
|
For mods that do not have such a file, the license is the source code license
|
||||||
of MineClone 2 and the author is Wuzzy.
|
of VoxeLibre and the author is Wuzzy.
|
||||||
|
|
||||||
## License of media (textures and sounds)
|
## License of media (textures and sounds)
|
||||||
No non-free licenses are used anywhere.
|
No non-free licenses are used anywhere.
|
||||||
|
|
|
@ -1,10 +1,10 @@
|
||||||
# Models in Minetest/Mineclone2
|
# Models in Minetest/VoxeLibre
|
||||||
|
|
||||||
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 VoxeLibre. 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 VoxeLibre.
|
||||||
|
|
||||||
## 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/VoxeLibre, please visit the Minetest wiki's page on using Blender [Here](https://wiki.minetest.net/Using_Blender)
|
||||||
|
|
||||||
## Recommended software
|
## Recommended software
|
||||||
|
|
||||||
|
|
18
README.md
|
@ -1,6 +1,6 @@
|
||||||
# MineClone2
|
# VoxeLibre
|
||||||
An unofficial Minecraft-like game for Minetest. Forked from MineClone by davedevils.
|
A game inspired by Minecraft for Minetest. Forked from MineClone by davedevils.
|
||||||
Developed by many people. Not developed or endorsed by Mojang AB.
|
Developed by many people, see CREDITS.md for a complete list.
|
||||||
|
|
||||||
### 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
|
||||||
|
@ -67,16 +67,16 @@ an explanation.
|
||||||
This game requires [Minetest](http://minetest.net) to run (version 5.4.1 or
|
This game requires [Minetest](http://minetest.net) to run (version 5.4.1 or
|
||||||
later). So you need to install Minetest first. Only stable versions of Minetest
|
later). So you need to install Minetest first. Only stable versions of Minetest
|
||||||
are officially supported.
|
are officially supported.
|
||||||
There is no support for running MineClone2 in development versions of Minetest.
|
There is no support for running VoxeLibre in development versions of Minetest.
|
||||||
|
|
||||||
To install MineClone2 (if you haven't already), move this directory into the
|
To install VoxeLibre (if you haven't already), move this directory into the
|
||||||
“games” directory of your Minetest data directory. Consult the help of
|
“games” directory of your Minetest data directory. Consult the help of
|
||||||
Minetest to learn more.
|
Minetest to learn more.
|
||||||
|
|
||||||
## Useful links
|
## Useful links
|
||||||
The MineClone2 repository is hosted at Mesehub. To contribute or report issues, head there.
|
The VoxeLibre repository is hosted at Mesehub. To contribute or report issues, head there.
|
||||||
|
|
||||||
* Mesehub: <https://git.minetest.land/MineClone2/MineClone2>
|
* Mesehub: <https://git.minetest.land/VoxeLibre/VoxeLibre>
|
||||||
* Discord: <https://discord.gg/xE4z8EEpDC>
|
* Discord: <https://discord.gg/xE4z8EEpDC>
|
||||||
* YouTube: <https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A>
|
* YouTube: <https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A>
|
||||||
* ContentDB: <https://content.minetest.net/packages/wuzzy/mineclone2/>
|
* ContentDB: <https://content.minetest.net/packages/wuzzy/mineclone2/>
|
||||||
|
@ -104,7 +104,7 @@ well on really low spec computers.
|
||||||
This game is currently in **beta** stage.
|
This game is currently in **beta** stage.
|
||||||
It is playable, but not yet feature-complete.
|
It is playable, but not yet feature-complete.
|
||||||
Backwards-compability is not entirely guaranteed, updating your world might cause small bugs.
|
Backwards-compability is not entirely guaranteed, updating your world might cause small bugs.
|
||||||
If you want to use the development version of MineClone2 in production, the master branch is usually relatively stable.
|
If you want to use the development version of VoxeLibre in production, the master branch is usually relatively stable.
|
||||||
|
|
||||||
The following main features are available:
|
The following main features are available:
|
||||||
|
|
||||||
|
@ -187,7 +187,7 @@ Technical differences from Minecraft:
|
||||||
* Different engine (Minetest)
|
* Different engine (Minetest)
|
||||||
* Different easter eggs
|
* Different easter eggs
|
||||||
|
|
||||||
… and finally, MineClone2 is free software (“free” as in “freedom”)!
|
… and finally, VoxeLibre is free software (“free” as in “freedom”)!
|
||||||
|
|
||||||
## Other readme files
|
## Other readme files
|
||||||
|
|
||||||
|
|
|
@ -69,7 +69,7 @@ Note: If you have to do more than 1 hotfix release, can do it on the same releas
|
||||||
|
|
||||||
### Release via ContentDB
|
### Release via ContentDB
|
||||||
|
|
||||||
* Go to MineClone2 page (https://content.minetest.net/packages/Wuzzy/mineclone2/)
|
* Go to VoxeLibre page (https://content.minetest.net/packages/Wuzzy/mineclone2/)
|
||||||
* Click +Release
|
* Click +Release
|
||||||
* Enter the release tag number in the title and Git reference box. For example (without quotes): "0.82.1"
|
* Enter the release tag number in the title and Git reference box. For example (without quotes): "0.82.1"
|
||||||
* In the minimum minetest version, put the oldest supported version (as of 14/02/2023 it is 5.5), leave the Maximum minetest version blank
|
* In the minimum minetest version, put the oldest supported version (as of 14/02/2023 it is 5.5), leave the Maximum minetest version blank
|
||||||
|
|
Before Width: | Height: | Size: 83 KiB After Width: | Height: | Size: 151 KiB |
Before Width: | Height: | Size: 82 KiB After Width: | Height: | Size: 152 KiB |
Before Width: | Height: | Size: 81 KiB After Width: | Height: | Size: 151 KiB |
Before Width: | Height: | Size: 82 KiB After Width: | Height: | Size: 151 KiB |
BIN
menu/header.png
Before Width: | Height: | Size: 82 KiB After Width: | Height: | Size: 152 KiB |
BIN
menu/icon.png
Before Width: | Height: | Size: 51 KiB After Width: | Height: | Size: 19 KiB |