diff --git a/API.md b/API.md index 865630c78..d957ca0f0 100644 --- a/API.md +++ b/API.md @@ -1,10 +1,10 @@ # API ## 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`. ## 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 ### Special fields @@ -31,7 +31,7 @@ All nodes can have these fields: Use the `mcl_sounds` mod for the sounds. ## 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 * 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: `ENTITIES/mcl_mobs` -MineClone 2 uses its own mobs framework, called “Mobs Redo: MineClone 2 Edition” or “MRM” for short. -This is a fork of Mobs Redo [`mobs`] by TenPlus1. +VoxeLibre uses its own mobs framework, which is a fork of Mobs Redo [`mobs`] by TenPlus1. You can add your own mobs, spawn eggs and spawning rules with this mod. 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 * Change player physics: `PLAYER/playerphysics` +* Change player FOV: `PLAYER/mcl_fovapi` * Select random treasures: `CORE/mcl_loot` * Get flowing direction of liquids: `CORE/flowlib` * `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 ### 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` * `_on_ignite` callback: `ITEMS/mcl_fire` diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 781b1b85f..466a142ab 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,21 +1,21 @@ -# Contributing to MineClone2 -So you want to contribute to MineClone2? +# Contributing to VoxeLibre +So you want to contribute to VoxeLibre? 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). -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. -## MineClone2's development target is to... -- Create a stable, peformant, moddable, free/libre game based on Minecraft +## VoxeLibre's development target is to... +- Create a stable, peformant, moddable, free/libre game inspired by Minecraft using the Minetest engine, usable in both singleplayer and multiplayer. - Currently, a lot of features are already implemented. Polishing existing features is always welcome. ## Links -* [Mesehub](https://git.minetest.land/MineClone2/MineClone2) +* [Mesehub](https://git.minetest.land/VoxeLibre/VoxeLibre) * [Discord](https://discord.gg/xE4z8EEpDC) * [YouTube](https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A) * [IRC](https://web.libera.chat/#mineclone2) @@ -26,23 +26,23 @@ Polishing existing features is always welcome. * [OpenCollective](https://opencollective.com/mineclone2) ## 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 project, it is **highly recommended** that you learn the git basics. 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 in learning how git works and its terminology. It can also help you keeping your game updated, and easily test pull requests. 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 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 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. ### 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 are a server admin, you can find error messages in the log file of the 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 the bug, e.g. before the crash happened or what causes the faulty behavior. @@ -84,14 +84,14 @@ behavior. * Ensure the requested feature fulfills our development targets and goals. * 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. 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. ### 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 new features from contributors. For most new things that get into the 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 reporting bugs that are the mainline (See Reporting bugs section). You can find currently open pull requests here: -. Note that pull +. Note that pull requests that start with a `WIP:` are not done yet and therefore could 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. +can have a look at the PR. The wiki has an article with instructions +on how to test Pull Requests: +. ### 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. 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. #### 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 -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 sounds is greatly appreciated, however if you add new sounds you should 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. #### 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). 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 @@ -154,7 +156,7 @@ also be credited in the Contributors section. ### Contributing Translations #### 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 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 @@ -178,7 +180,7 @@ If you have commited the results yourself, you will also be credited in the Contributors section. ### 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 information about the game's performance and let us know places to 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). ## 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 * 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. ### 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 -for questions about git, Lua, Minetest API, MineClone2 codebase or -anything related to MineClone2. We can help you avoid writing code that -would be deemed inadequate, or help you become familiar with MineClone2 +for questions about git, Lua, Minetest API, VoxeLibre codebase or +anything related to VoxeLibre. We can help you avoid writing code that +would be deemed inadequate, or help you become familiar with VoxeLibre better, or assist you use development tools. ### Maintain your own code, even if already got merged @@ -271,8 +273,8 @@ of the results) excessive git bureaucracy commits in 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 -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) +b) it is 100% certain that no VL specific changes to the code will be +needed (this has never been the case before, hence VL is submodule free so far) * Commit messages should be descriptive * Try to group your submissions best as you can: * Try to keep your PRs small: In some cases things reasonably be can't @@ -357,14 +359,14 @@ end ### Developer status 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 most trusted contributors who will contribute to ensure coding standards and processes are followed. #### Developer responsibilities - 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 before they get merged. - If you do not (yet) have developer privs you do your work on a branch @@ -397,7 +399,7 @@ technical guidelines #### Release process * Run `tools/generate_ingame_credits.lua` to update the ingame credits 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 * Use `git tag ` to tag the latest commit with the version number diff --git a/GROUPS.md b/GROUPS.md index 0eb2d2d7c..18510430e 100644 --- a/GROUPS.md +++ b/GROUPS.md @@ -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 * `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 to learn how digging times work in Minecraft, as MineClone 2 is based on the same system. +Please read to learn how digging times work in Minecraft, as VoxeLibre is based on the same system. ### Groups for interactions @@ -117,7 +117,7 @@ These groups correspond to the Minecraft materials. They classify the block into * `material_glass=1`: Glass 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 These groups are used mostly for informational purposes diff --git a/HOW_TO_PLAY.md b/HOW_TO_PLAY.md index bc6cad1a5..39f0f9cc4 100644 --- a/HOW_TO_PLAY.md +++ b/HOW_TO_PLAY.md @@ -6,16 +6,16 @@ How to play: - Navigate to https://www.minetest.net/ to download the client. - 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) -- Find "MineClone2" (should be first on the list or on the first page) -- Click the [+] button next to MineClone2 and wait for download to finish +- Find "VoxeLibre" (should be first on the list or on the first page) +- Click the [+] button next to VoxeLibre and wait for download to finish - Click "Back to Main Menu" #### Create new world and play - 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 - You can leave seed blank or put in a word of your choice - Select your new world -- Click "Play Game" and enjoy! \ No newline at end of file +- Click "Play Game" and enjoy! diff --git a/LEGAL.md b/LEGAL.md index a181da398..d95f17624 100644 --- a/LEGAL.md +++ b/LEGAL.md @@ -1,14 +1,14 @@ # 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 Here's the detailed legalese for those who need it: ## License of source code -MineClone 2 (by Lizzy Fleckenstein, Wuzzy, davedevils and countless others) -is an imitation of Minecraft. +VoxeLibre (by Lizzy Fleckenstein, Wuzzy, davedevils and countless others) +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 the Free Software Foundation, either version 3 of the License, or (at your option) any later version. @@ -22,15 +22,15 @@ details. In the mods you might find in the read-me or license text files a different license. This counts as dual-licensing. 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. Mod credits: 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 -of MineClone 2 and the author is Wuzzy. +of VoxeLibre and the author is Wuzzy. ## License of media (textures and sounds) No non-free licenses are used anywhere. diff --git a/MODELS.md b/MODELS.md index 663313f30..60a21c3ce 100644 --- a/MODELS.md +++ b/MODELS.md @@ -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 -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 diff --git a/README.md b/README.md index 4dc0ee92d..06b31b276 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# MineClone2 -An unofficial Minecraft-like game for Minetest. Forked from MineClone by davedevils. -Developed by many people. Not developed or endorsed by Mojang AB. +# VoxeLibre +A game inspired by Minecraft for Minetest. Forked from MineClone by davedevils. +Developed by many people, see CREDITS.md for a complete list. ### Gameplay 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 later). So you need to install Minetest first. Only stable versions of Minetest 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 Minetest to learn more. ## 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: +* Mesehub: * Discord: * YouTube: * ContentDB: @@ -104,7 +104,7 @@ well on really low spec computers. This game is currently in **beta** stage. It is playable, but not yet feature-complete. 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: @@ -187,7 +187,7 @@ Technical differences from Minecraft: * Different engine (Minetest) * 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 diff --git a/RELEASE.md b/RELEASE.md index 3984c4c84..d28c0d20d 100644 --- a/RELEASE.md +++ b/RELEASE.md @@ -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 -* Go to MineClone2 page (https://content.minetest.net/packages/Wuzzy/mineclone2/) +* Go to VoxeLibre page (https://content.minetest.net/packages/Wuzzy/mineclone2/) * Click +Release * 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