mirror of
https://git.minetest.land/VoxeLibre/VoxeLibre.git
synced 2024-11-24 03:21:05 +01:00
Update Minetest->Luanti and minetest.net->luanti.org in README.md and CONTRIBUTING.md, fix typo in README.md
This commit is contained in:
parent
4dc5d0939c
commit
85797107fd
2 changed files with 27 additions and 27 deletions
|
@ -10,7 +10,7 @@ whether you're a programmer or not.
|
||||||
|
|
||||||
## VoxeLibre's development target is to...
|
## VoxeLibre's development target is to...
|
||||||
- Create a stable, peformant, moddable, free/libre game inspired by Minecraft
|
- Create a stable, peformant, moddable, free/libre game inspired by Minecraft
|
||||||
using the Minetest engine, usable in both singleplayer and multiplayer.
|
using the Luanti 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.
|
||||||
|
|
||||||
|
@ -20,8 +20,8 @@ Polishing existing features is always welcome.
|
||||||
* [YouTube](https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A)
|
* [YouTube](https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A)
|
||||||
* [Matrix](https://app.element.io/#/room/#voxelibre:matrix.org)
|
* [Matrix](https://app.element.io/#/room/#voxelibre:matrix.org)
|
||||||
* [Reddit](https://www.reddit.com/r/VoxeLibre/)
|
* [Reddit](https://www.reddit.com/r/VoxeLibre/)
|
||||||
* [Minetest forums](https://forum.minetest.net/viewtopic.php?f=50&t=16407)
|
* [Luanti forums](https://forum.luanti.org/viewtopic.php?f=50&t=16407)
|
||||||
* [ContentDB](https://content.minetest.net/packages/wuzzy/mineclone2/)
|
* [ContentDB](https://content.luanti.org/packages/wuzzy/mineclone2/)
|
||||||
* [OpenCollective](https://opencollective.com/mineclone2)
|
* [OpenCollective](https://opencollective.com/mineclone2)
|
||||||
|
|
||||||
## Using git
|
## Using git
|
||||||
|
@ -39,7 +39,7 @@ 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 Luanti 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/VoxeLibre/VoxeLibre/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.
|
||||||
|
@ -53,10 +53,10 @@ discussion.
|
||||||
Try not to 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. This can often be ambiguous though.
|
that already have been requested. This can often be ambiguous though.
|
||||||
If in doubt open an issue!
|
If in doubt open an issue!
|
||||||
* If you know about Minetest's inner workings, please think about
|
* If you know about Luanti'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 Luanti itself, and if it is, head to the
|
||||||
[Minetest issue tracker](https://github.com/minetest/minetest/issues)
|
[Luanti issue tracker](https://github.com/minetest/minetest/issues)
|
||||||
instead.
|
instead.
|
||||||
* If you need any help regarding creating a Mesehub account or opening
|
* If you need any help regarding creating a Mesehub account or opening
|
||||||
an issue, feel free to ask on the Discord or Matrix space.
|
an issue, feel free to ask on the Discord or Matrix space.
|
||||||
|
@ -69,11 +69,11 @@ The link to the mesehub registration page is: https://git.minetest.land/user/sig
|
||||||
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
|
||||||
game. In this case, please read "Requesting features"
|
game. In this case, please read "Requesting features"
|
||||||
* If you report a crash, always include the error message. If you play
|
* If you report a crash, always include the error message. If you play
|
||||||
in singleplayer, post a screenshot of the message that Minetest showed
|
in singleplayer, post a screenshot of the message that Luanti 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 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 which VoxeLibre and Luanti versions you are using (from Luanti 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.
|
||||||
|
@ -182,13 +182,13 @@ 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.
|
||||||
|
|
||||||
#### Using Minetest's profiler
|
#### Using Luanti's profiler
|
||||||
We frequently will use profiling to optimise our code. We recommend use of
|
We frequently will use profiling to optimise our code. We recommend use of
|
||||||
the JIT profiler (RIP Jude) to fully understand performance impact:
|
the JIT profiler (RIP Jude) to fully understand performance impact:
|
||||||
|
|
||||||
https://content.minetest.net/packages/jwmhjwmh/jitprofiler/
|
https://content.luanti.org/packages/jwmhjwmh/jitprofiler/
|
||||||
|
|
||||||
Minetest also has a built in profiler. Simply set `profiler.load = true` in
|
Luanti also has a built in profiler. Simply set `profiler.load = true` in
|
||||||
your configuration file and restart the server. After running the server
|
your configuration file and restart the server. After running the server
|
||||||
for some time, just run `/profiler save` in chat - then you will find a
|
for some time, just run `/profiler save` in chat - then you will find a
|
||||||
file in the world directory containing the results. Open a new issue and
|
file in the world directory containing the results. Open a new issue and
|
||||||
|
@ -243,7 +243,7 @@ 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 VoxeLibre. If you are a
|
We appreciate any contributing effort to VoxeLibre. If you are a
|
||||||
relatively new programmer, you can reach us on Discord or Matrix
|
relatively new programmer, you can reach us on Discord or Matrix
|
||||||
for questions about git, Lua, Minetest API, VoxeLibre codebase or
|
for questions about git, Lua, Luanti API, VoxeLibre codebase or
|
||||||
anything related to VoxeLibre. 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 VoxeLibre
|
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.
|
||||||
|
@ -294,7 +294,7 @@ split up but in general multiple small PRs are better than a big one
|
||||||
* Each mod must provide `mod.conf`.
|
* Each mod must provide `mod.conf`.
|
||||||
* Mod names are snake case, and newly added mods (or substantially changed mods
|
* Mod names are snake case, and newly added mods (or substantially changed mods
|
||||||
that are included from the outside) start with `vl_`, e.g.
|
that are included from the outside) start with `vl_`, e.g.
|
||||||
`vl_hollow_logs`, . Keep in mind Minetest
|
`vl_hollow_logs`, . Keep in mind Luanti
|
||||||
does not support capital letters in mod names.
|
does not support capital letters in mod names.
|
||||||
* In the past mods were prefixed with `mcl_`, e.g.
|
* In the past mods were prefixed with `mcl_`, e.g.
|
||||||
`mcl_core`, `mcl_farming`, `mcl_monster_eggs`. New mods should **never** use this prefix.
|
`mcl_core`, `mcl_farming`, `mcl_monster_eggs`. New mods should **never** use this prefix.
|
||||||
|
@ -325,7 +325,7 @@ function mcl_example.do_something()
|
||||||
end
|
end
|
||||||
```
|
```
|
||||||
|
|
||||||
* Use modern Minetest API, e.g. no usage of `minetest.env`
|
* Use modern Luanti API, e.g. no usage of `minetest.env`
|
||||||
* Tabs should be used for indent, spaces for alignment, e.g.
|
* Tabs should be used for indent, spaces for alignment, e.g.
|
||||||
|
|
||||||
```lua
|
```lua
|
||||||
|
|
24
README.md
24
README.md
|
@ -1,5 +1,5 @@
|
||||||
# VoxeLibre
|
# VoxeLibre
|
||||||
A game inspired by Minecraft for Minetest. Forked from MineClone by davedevils.
|
A game inspired by Minecraft for Luanti. Forked from MineClone by davedevils.
|
||||||
Developed by many people, see CREDITS.md for a complete list.
|
Developed by many people, see CREDITS.md for a complete list.
|
||||||
|
|
||||||
### Gameplay
|
### Gameplay
|
||||||
|
@ -65,16 +65,16 @@ an explanation.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
To run the game with the best performance and support, we recommend the latest
|
To run the game with the best performance and support, we recommend the latest
|
||||||
stable version of [Minetest](http://minetest.net), be we always make an effort
|
stable version of [Luanti](https://www.luanti.org/), but we always make an effort
|
||||||
to support one version behind the latest stable version. In some cases, older
|
to support one version behind the latest stable version. In some cases, older
|
||||||
versions might still be good enough but you would be missing out on important
|
versions might still be good enough but you would be missing out on important
|
||||||
Minetest features that enable important features for our game.
|
Luanti features that enable important features for our game.
|
||||||
|
|
||||||
There is no support for running VoxeLibre in development versions of Minetest.
|
There is no support for running VoxeLibre in development versions of Luanti.
|
||||||
|
|
||||||
To install VoxeLibre (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 Luanti data directory. Consult the help of
|
||||||
Minetest to learn more.
|
Luanti to learn more.
|
||||||
|
|
||||||
## Useful links
|
## Useful links
|
||||||
The VoxeLibre 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.
|
||||||
|
@ -82,18 +82,18 @@ The VoxeLibre repository is hosted at Mesehub. To contribute or report issues, h
|
||||||
* Mesehub: <https://git.minetest.land/VoxeLibre/VoxeLibre>
|
* 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.luanti.org/packages/wuzzy/mineclone2/>
|
||||||
* OpenCollective: <https://opencollective.com/voxelibre>
|
* OpenCollective: <https://opencollective.com/voxelibre>
|
||||||
* Mastodon: <https://fosstodon.org/@VoxeLibre>
|
* Mastodon: <https://fosstodon.org/@VoxeLibre>
|
||||||
* Lemmy: <https://lemm.ee/c/voxelibre>
|
* Lemmy: <https://lemm.ee/c/voxelibre>
|
||||||
* Matrix space: <https://app.element.io/#/room/#voxelibre:matrix.org>
|
* Matrix space: <https://app.element.io/#/room/#voxelibre:matrix.org>
|
||||||
* Minetest forums: <https://forum.minetest.net/viewtopic.php?f=50&t=16407>
|
* Luanti forums: <https://forum.luanti.org/viewtopic.php?f=50&t=16407>
|
||||||
* Reddit: <https://www.reddit.com/r/VoxeLibre/>
|
* Reddit: <https://www.reddit.com/r/VoxeLibre/>
|
||||||
* IRC (barely used): <https://web.libera.chat/#mineclone2>
|
* IRC (barely used): <https://web.libera.chat/#mineclone2>
|
||||||
|
|
||||||
## Target
|
## Target
|
||||||
- Create a stable, peformant, moddable, free/libre game inspired by Minecraft
|
- Create a stable, peformant, moddable, free/libre game inspired by Minecraft
|
||||||
using the Minetest engine, usable in both singleplayer and multiplayer.
|
using the Luanti 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.
|
||||||
|
|
||||||
|
@ -160,7 +160,7 @@ Bonus features (not found in Minecraft):
|
||||||
* In-game help system containing extensive help about gameplay basics, blocks, items and more
|
* In-game help system containing extensive help about gameplay basics, blocks, items and more
|
||||||
* Temporary crafting recipes. They only exist to make some otherwise unaccessible items available when you're not in creative mode. These recipes will be removed as development goes on an more features become available
|
* Temporary crafting recipes. They only exist to make some otherwise unaccessible items available when you're not in creative mode. These recipes will be removed as development goes on an more features become available
|
||||||
* Saplings in chests in [mapgen v6](https://wiki.minetest.net/Map_generator#v6)
|
* Saplings in chests in [mapgen v6](https://wiki.minetest.net/Map_generator#v6)
|
||||||
* Fully moddable (thanks to Minetest's powerful Lua API)
|
* Fully moddable (thanks to Luanti's powerful Lua API)
|
||||||
* New blocks and items:
|
* New blocks and items:
|
||||||
* Lookup tool, shows you the help for whatever it touches
|
* Lookup tool, shows you the help for whatever it touches
|
||||||
* More slabs and stairs
|
* More slabs and stairs
|
||||||
|
@ -181,7 +181,7 @@ Technical differences from Minecraft:
|
||||||
* Different music for jukebox
|
* Different music for jukebox
|
||||||
* Different textures (Pixel Perfection)
|
* Different textures (Pixel Perfection)
|
||||||
* Different sounds (various sources)
|
* Different sounds (various sources)
|
||||||
* Different engine (Minetest)
|
* Different engine (Luanti)
|
||||||
* Different easter eggs
|
* Different easter eggs
|
||||||
|
|
||||||
… and finally, VoxeLibre is free software (“free” as in “freedom”)!
|
… and finally, VoxeLibre is free software (“free” as in “freedom”)!
|
||||||
|
@ -190,6 +190,6 @@ Technical differences from Minecraft:
|
||||||
|
|
||||||
* `LICENSE.txt`: The GPLv3 license text
|
* `LICENSE.txt`: The GPLv3 license text
|
||||||
* `CONTRIBUTING.md`: Information for those who want to contribute
|
* `CONTRIBUTING.md`: Information for those who want to contribute
|
||||||
* `API.md`: For Minetest modders who want to mod this game
|
* `API.md`: For Luanti modders who want to mod this game
|
||||||
* `LEGAL.md`: Legal information
|
* `LEGAL.md`: Legal information
|
||||||
* `CREDITS.md`: List of everyone who contributed
|
* `CREDITS.md`: List of everyone who contributed
|
||||||
|
|
Loading…
Reference in a new issue