VoxeLibre/README.md

196 lines
7.7 KiB
Markdown
Raw Permalink Normal View History

# VoxeLibre
A game inspired by Minecraft for Minetest. Forked from MineClone by davedevils.
Developed by many people, see CREDITS.md for a complete list.
2015-07-03 07:24:21 +02:00
2017-02-08 18:17:11 +01:00
### Gameplay
You start in a randomly-generated world made entirely of cubes. You can explore
the world and dig and build almost every block in the world to create new
structures. You can choose to play in a “survival mode” in which you have to
fight monsters and hunger for survival and slowly progress through the
various other aspects of the game, such as mining, farming, building machines, and so on
Or you can play in “creative mode” in which you can build almost anything instantly.
2017-02-10 17:24:33 +01:00
#### Gameplay summary
2021-01-03 14:21:50 +01:00
* Sandbox-style gameplay, no goals
2017-02-08 18:17:11 +01:00
* Survive: Fight against hostile monsters and hunger
* Mine for ores and other treasures
2021-01-03 14:21:50 +01:00
* Magic: Gain experience and enchant your tools
2017-02-08 18:17:11 +01:00
* Use the collected blocks to create great buildings, your imagination is the limit
* Collect flowers (and other dye sources) and colorize your world
* Find some seeds and start farming
* Find or craft one of hundreds of items
* Build a railway system and have fun with minecarts
* Build complex machines with redstone circuits
* In creative mode you can build almost anything for free and without limits
## How to play (quick start)
### Getting started
2017-02-22 00:26:08 +01:00
* **Punch a tree** trunk until it breaks and collect wood
* Place the **wood into the 2×2 grid** (your “crafting grid” in your inventory menu) and craft 4 wood planks
2017-02-22 00:26:08 +01:00
* Place the 4 wood planks in a 2×2 shape in the crafting grid to **make a crafting table**
* **Rightclick the crafting table** for a 3×3 crafting grid to craft more complex things
* Use the **crafting guide** (book icon) to learn all the possible crafting recipes
* **Craft a wooden pickaxe** so you can dig stone
2017-02-08 18:17:11 +01:00
* Different tools break different kinds of blocks. Try them out!
* Continue playing as you wish. Have fun!
### Farming
* Find seeds
* Craft a hoe
* Rightclick dirt or a similar block with a hoe to create farmland
2017-02-08 18:17:11 +01:00
* Place seeds on farmland and watch them grow
* Collect plants when fully grown
2017-02-08 18:17:11 +01:00
* If near water, farmland becomes wet and speeds up growth
### Furnace
* Craft a furnace
* The furnace allows you to obtain more items
2017-02-08 18:17:11 +01:00
* Upper slot must contain a smeltable item (example: iron ore)
* Lower slot must contain a fuel item (example: coal)
* See tooltips in crafting guide to learn about fuels and smeltable items
### Additional help
2017-03-20 22:27:24 +01:00
More help about the gameplay, blocks items and much more can be found from inside
the game. You can access the help from your inventory menu.
2017-02-08 18:17:11 +01:00
### Special items
The following items are interesting for Creative Mode and for adventure
2017-05-23 23:36:52 +02:00
map builders. They can not be obtained in-game or in the creative inventory.
* Barrier: `mcl_core:barrier`
Use the `/giveme` chat command to obtain them. See the in-game help for
an explanation.
2017-02-08 18:17:11 +01:00
## Installation
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
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
Minetest features that enable important features for our game.
There is no support for running VoxeLibre in development versions of Minetest.
2019-03-07 13:51:21 +01:00
To install VoxeLibre (if you haven't already), move this directory into the
2019-03-07 13:51:21 +01:00
“games” directory of your Minetest data directory. Consult the help of
Minetest to learn more.
2017-02-08 18:17:11 +01:00
2021-07-06 11:02:59 +02:00
## Useful links
The VoxeLibre repository is hosted at Mesehub. To contribute or report issues, head there.
2021-07-06 11:02:59 +02:00
* Mesehub: <https://git.minetest.land/VoxeLibre/VoxeLibre>
2021-07-06 11:02:59 +02:00
* Discord: <https://discord.gg/xE4z8EEpDC>
2023-03-13 09:55:27 +01:00
* YouTube: <https://www.youtube.com/channel/UClI_YcsXMF3KNeJtoBfnk9A>
2021-11-08 14:02:22 +01:00
* ContentDB: <https://content.minetest.net/packages/wuzzy/mineclone2/>
* OpenCollective: <https://opencollective.com/voxelibre>
2024-05-19 01:34:43 +02:00
* Mastodon: <https://fosstodon.org/@VoxeLibre>
2024-05-07 12:57:41 +02:00
* Lemmy: <https://lemm.ee/c/voxelibre>
* Matrix space: <https://app.element.io/#/room/#voxelibre:matrix.org>
2023-07-20 23:37:49 +02:00
* Minetest forums: <https://forum.minetest.net/viewtopic.php?f=50&t=16407>
2024-05-07 12:57:41 +02:00
* Reddit: <https://www.reddit.com/r/VoxeLibre/>
2023-07-20 23:37:49 +02:00
* IRC (barely used): <https://web.libera.chat/#mineclone2>
2021-04-12 14:03:51 +02:00
## Target
2024-05-19 01:34:43 +02:00
- 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.
2021-04-12 17:36:44 +02:00
2017-01-16 01:24:55 +01:00
## Completion status
2021-04-12 14:03:51 +02:00
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 VoxeLibre in production, the master branch is usually relatively stable.
2017-02-08 18:17:11 +01:00
The following main features are available:
2018-01-27 02:35:45 +01:00
* Tools, weapons
2021-01-03 14:21:50 +01:00
* Armor
2017-02-08 18:17:11 +01:00
* Crafting system: 2×2 grid, crafting table (3×3 grid), furnace, including a crafting guide
* Chests, large chests, ender chests, shulker boxes
2018-01-31 21:24:35 +01:00
* Furnaces, hoppers
2017-05-23 20:19:51 +02:00
* Hunger
2017-07-06 15:46:15 +02:00
* Most monsters and animals
2017-02-08 18:17:11 +01:00
* All ores from Minecraft
* Most blocks in the overworld
* Water and lava
2017-02-22 00:23:32 +01:00
* Weather
* 28 biomes + 5 Nether Biomes
2017-09-14 03:52:39 +02:00
* The Nether, a fiery underworld in another dimension
2018-01-27 02:35:45 +01:00
* Redstone circuits (partially)
2017-02-08 18:17:11 +01:00
* Minecarts (partial)
2020-08-22 11:28:36 +02:00
* Status effects (partial)
2021-01-03 14:21:50 +01:00
* Experience
* Enchanting
2020-08-22 11:28:36 +02:00
* Brewing, potions, tipped arrow (partial)
2017-07-25 23:18:22 +02:00
* Boats
2017-02-08 18:17:11 +01:00
* Fire
* Buidling blocks: Stairs, slabs, doors, trapdoors, fences, fence gates, walls
* Clock
* Compass
* Sponge
2021-04-12 14:03:51 +02:00
* Slime block
2017-07-25 23:18:22 +02:00
* Small plants and saplings
2017-02-08 18:17:11 +01:00
* Dyes
2017-07-29 15:45:49 +02:00
* Banners
2017-02-08 18:17:11 +01:00
* Deco blocks: Glass, stained glass, glass panes, iron bars, hardened clay (and colors), heads and more
* Item frames
* Jukeboxes
* Beds
* Inventory menu
* Creative inventory
2017-05-23 20:19:51 +02:00
* Farming
2017-07-25 23:18:22 +02:00
* Writable books
2021-04-12 14:03:51 +02:00
* Commands
* Villages
* The End
2017-02-08 18:17:11 +01:00
* And more!
The following features are incomplete:
2017-02-10 17:24:33 +01:00
2017-07-06 15:46:15 +02:00
* Some monsters and animals
2017-09-14 03:52:39 +02:00
* Redstone-related things
2022-12-31 14:16:52 +01:00
* Some special minecarts (hopper and chest minecarts work)
2017-02-08 18:17:11 +01:00
* A couple of non-trivial blocks and items
Bonus features (not found in Minecraft):
2017-02-10 17:24:33 +01:00
2017-02-08 18:17:11 +01:00
* Built-in crafting guide which shows you crafting and smelting recipes
2021-04-13 08:35:09 +02:00
* In-game help system containing extensive help about gameplay basics, blocks, items and more
2017-07-25 23:18:22 +02:00
* 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)
2018-01-27 02:35:45 +01:00
* Fully moddable (thanks to Minetest's powerful Lua API)
2021-04-13 08:35:09 +02:00
* New blocks and items:
* Lookup tool, shows you the help for whatever it touches
* More slabs and stairs
* Nether Brick Fence Gate
* Red Nether Brick Fence
* Red Nether Brick Fence Gate
* Structure replacements - these small variants of Minecraft structures serve as replacements until we can get large structures working:
* Woodland Cabin (Mansions)
* Nether Outpost (Fortress)
2017-02-08 18:17:11 +01:00
Technical differences from Minecraft:
2017-02-10 17:24:33 +01:00
2017-07-25 23:18:22 +02:00
* Height limit of ca. 31000 blocks (much higher than in Minecraft)
* Horizontal world size is ca. 62000×62000 blocks (much smaller than in Minecraft, but it is still very large)
2018-01-27 02:35:45 +01:00
* Still very incomplete and buggy
2017-07-25 23:18:22 +02:00
* Blocks, items, enemies and other features are missing
2017-02-08 18:17:11 +01:00
* A few items have slightly different names to make them easier to distinguish
* Different music for jukebox
2017-07-25 23:18:22 +02:00
* Different textures (Pixel Perfection)
* Different sounds (various sources)
* Different engine (Minetest)
2021-04-12 14:03:51 +02:00
* Different easter eggs
2018-01-27 02:35:45 +01:00
… and finally, VoxeLibre is free software (“free” as in “freedom”)!
2015-07-03 07:24:21 +02:00
2017-02-12 22:02:50 +01:00
## Other readme files
* `LICENSE.txt`: The GPLv3 license text
2017-02-12 22:02:50 +01:00
* `CONTRIBUTING.md`: Information for those who want to contribute
2017-02-22 00:23:32 +01:00
* `API.md`: For Minetest modders who want to mod this game
2021-04-12 14:03:51 +02:00
* `LEGAL.md`: Legal information
* `CREDITS.md`: List of everyone who contributed