VoxeLibre (formerly known as MineClone2), a voxel-based sandbox game for Minetest
Go to file
Wuzzy 036aa7b82d Move hotbar images to mcl_base_textures 2017-07-20 17:48:20 +02:00
menu Footer: “Expect slightly less horrible bugs.” 2017-06-13 00:34:01 +02:00
mods Move hotbar images to mcl_base_textures 2017-07-20 17:48:20 +02:00
tools Add texture conversion helper script 2017-07-19 22:44:43 +02:00
API.md Add central API documentation hub 2017-02-21 21:28:58 +01:00
CONTRIBUTING.md Mention the new bug tracker in README files 2017-02-20 16:56:23 +01:00
GROUPS.md Set list of nodes which can be taken by endermen 2017-07-05 20:14:37 +02:00
LICENSE.txt Markdown format for README, rename other file 2017-02-08 13:11:28 +01:00
MISSING_ENGINE_FEATURES.md Mention two sneak-click-related missing engine features 2017-02-17 04:59:58 +01:00
README.md Version 0.23.1 2017-07-07 23:30:14 +02:00
game.conf Rename to MineClone 2 2017-01-12 17:07:03 +01:00
minetest.conf Remove movement_speed_descend (unused) 2017-06-03 13:39:34 +02:00
settingtypes.txt Disable experimental progressive mode by default 2017-07-06 03:00:46 +02:00

README.md

MineClone 2

An unofficial Minecraft-like game for Minetest. Forked from MineClone by daredevils. Developed by Wuzzy and contributors. Not developed or endorsed by Mojang AB.

Version: 0.23.1

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.

Gameplay summary

  • Sandbox-style gameplay, no goals (for now)
  • Survive: Fight against hostile monsters and hunger
  • Mine for ores and other treasures
  • 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

  • Use the world generator “v6”!
  • 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
  • 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
  • Different tools break different kinds of blocks. Try them out!
  • Continue playing as you wish. Have fun!

Farming

  • Find seeds
  • Craft hoe
  • Rightclick dirt or similar block with hoe to create farmland
  • Place seeds on farmland and watch them grow
  • Collect plant when fully grown
  • If near water, farmland becomes wet and speeds up growth

Furnace

  • Craft furnace
  • Furnace allows you to obtain more items
  • 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

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.

Special blocks

The following blocks are interesting for Creative Mode and for adventure map builders. They can not be obtained in-game or in the creative inventory.

  • Barrier: mcl_core:barrier
  • Command Block: mesecons_commandblock:commandblock_off
  • Monster Spawner (WIP): mcl_mobspawners:spawner
  • Huge mushroom blocks: See mods/ITEMS/mcl_mushrooms/README.md

Use the /giveme chat command to obtain them. See the in-game help for an explanation.

Installation

This game requires Minetest 0.4.16 (or later) to run, so you need to install Minetest first. Only stable versions of Minetest are officially supported. There is no support whatsoever for running MineClone 2 in development versions of Minetest. To install MineClone 2, move this directory into the “games” directory of your Minetest data directory. Consult the help of Minetest to learn more.

The MineClone 2 icon has two grass blocks.

Completion status

This game is very unfinished at this moment. Expect bugs! Expect chaos and destruction to rain down on your worlds whenever you update! ;-)

The following main features are available:

  • Tools, weapons and armor
  • Crafting system: 2×2 grid, crafting table (3×3 grid), furnace, including a crafting guide
  • Chests, large chests, ender chests, shulker boxes
  • Hunger
  • Most monsters and animals
  • All ores from Minecraft
  • Most blocks in the overworld
  • Water and lava
  • Weather
  • Redstone circuits (partially): Redstone ore, redstone, redstone repeater, levers, buttons, redstone blocks, redstone lamps
  • Minecarts (partial)
  • Fire
  • Buidling blocks: Stairs, slabs, doors, trapdoors, fences, fence gates, walls
  • Clock
  • Compass
  • Sponge
  • Slime block (incomplete)
  • All flowers and grasses
  • Dyes
  • Deco blocks: Glass, stained glass, glass panes, iron bars, hardened clay (and colors), heads and more
  • Item frames
  • Jukeboxes
  • Beds
  • Inventory menu
  • Creative inventory
  • Farming
  • Bookshelves
  • Books
  • More server commands
  • 3D torches
  • And more!

The following features are incomplete:

  • Trees, biomes, generated structures
  • NPCs
  • Some monsters and animals
  • Some redstone-related things
  • The Nether
  • The End
  • Enchanting
  • Experience
  • Status effects
  • Brewing, potions, tipped arrows
  • Anvil
  • A couple of non-trivial blocks and items

Bonus features (not found in Minecraft 1.11):

  • Built-in crafting guide which shows you crafting and smelting recipes
  • In-game help system containing extensive help about gameplay basics, blocks, items and more
  • New 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

Technical differences from Minecraft:

  • Still very, very incomplete and buggy
  • Many blocks, items, enemies and other features are missing
  • A few items have slightly different names to make them easier to distinguish
  • Free software (“free” as in freedom and free beer)
  • Different music for jukebox
  • Different textures (Faithful 1.11)
  • Different engine
  • 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)

Project description

The main goal of MineClone 2 is to be a clone of Minecraft and to be released as free software. The focus on this clone lies especially on gameplay and to reflect it as good as possible. Ideally, no gameplay features will be added or removed. A secondary goal is to make modding easy as pie. Minetest is of great help here! Trying to stay faithful to the original look and feel is a side goal, but not an important one. If deemed neccessary, MineClone 2 will deviate from Minecraft in interface issues. There's already a built-in crafting guide and a full-blown in-game help system. Finally, any limitations found in Minetest (the game engine) will be written down in the course of development.

Reporting bugs

Report all bugs and missing Minecraft features here:

https://github.com/Wuzzy2/MineClone2-Bugs

Other readme files

  • LICENSE.txt: The LGPLv2.1 license text
  • CONTRIBUTING.md: Information for those who want to contribute
  • MISSING_ENGINE_FEATURES.md: List of missing features in Minetest which MineClone 2 would need for improvement
  • API.md: For Minetest modders who want to mod this game

Credits

There are so many people to list (sorry).

Mods

TO BE WRITTEN.

Special thanks

  • daredevils for starting this project
  • Tox82, MinetestForFun & Calinou for help in dev
  • GravGun & Obani for Help in Build struct
  • celeron55 for creating Minetest
  • Bob Lennon because it's a pyro-barbare
  • Minetest's modding community for providing a huge selection of mods, some of which ended up in MineClone 2
  • Jordach for the jukebox music compilation from Big Freaking Dig
  • The workaholics who spent hours writing for the Minecraft Wiki. It's an invaluable resource for creating this game
  • Notch and Jeb for being the bigg

Info for programmers

You find interesting and useful infos in API.md. This project is currently mostly a one-person project.

This is a fan game, not developed or endorsed by Mojang AB.

Copying is an act of love. Please copy and share! <3 But, oh well, if you insist, here is the legalese for you:

License of source code

MineClone source code: LGPL v2.1 (daredevils and others) (see LICENSE.txt)

Mods credit: See README.txt or README.md in each mod directory for information about other authors.

License of media (textures and sounds)

The textures, unless otherwise noted, are taken from the Faithful 1.11 resource pack for Minecraft, authored by Vattic, xMrVizzy and many others. Source: http://www.minecraftforum.net/topic/72747-/

The license of this texture pack is the MIT license.

The textures for the mobs are from the Pixel Perfection resource pack for Minecraft. See ENTITIES/mobs_mc/README.md for detailed information.

License of all main menu images: WTFPL

All other files, unless mentioned otherwise, fall under: Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0) http://creativecommons.org/licenses/by-sa/3.0/

See README.txt in each mod directory for detailed information about other authors.