VoxeLibre/README.md

256 lines
11 KiB
Markdown
Raw Normal View History

2017-01-16 01:24:55 +01:00
# MineClone 2
2017-03-09 21:42:55 +01:00
An unofficial Minecraft-like game for Minetest. Forked from MineClone by daredevils.
Developed by Wuzzy and contributors. Not developed or endorsed by Mojang AB.
2015-07-03 07:24:21 +02:00
2017-09-19 19:53:38 +02:00
Version: 0.29.1
2017-02-17 00:09:05 +01: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
2017-02-08 18:17:11 +01:00
* 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
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
* 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 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
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`
* Command Block: `mesecons_commandblock:commandblock_off`
* Monster Spawner: `mcl_mobspawners:spawner`
2017-05-23 23:36:52 +02:00
* Huge mushroom blocks: See `mods/ITEMS/mcl_mushrooms/README.md`
* Minecart with Command Block: `mcl_minecarts:command_block_minecart`
2017-05-23 23:36:52 +02:00
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
2017-06-11 20:28:27 +02:00
This game requires [Minetest](http://minetest.net) 0.4.16 (or later) to run,
2017-05-23 20:19:51 +02:00
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.
2017-02-08 18:17:11 +01:00
2017-07-25 23:18:22 +02:00
## Project description
The main goal of **MineClone 2** is to be a clone of Minecraft and to be released as free software.
* **Target of development: Minecraft, PC Edition, version 1.11** (later known as “Java Edition”)
* Features of later Minecraft versions might sneak in, but they have a low priority
* In general, Minecraft is aimed to be cloned as good as Minetest currently permits (no hacks)
* Cloning the gameplay has highest priority
* MineClone 2 will use different graphics and sounds, but with a similar style
* Cloning the interface has no priority. It will only be roughly imitated
* Limitations found in Minetest will be written down and reported in the course of development
2017-02-08 18:17:11 +01:00
2017-01-16 01:24:55 +01:00
## Completion status
2017-07-25 23:18:22 +02:00
This game is currently in **alpha** stage.
It is playable, but very unfinished, many bugs are to be expected.
Backwards-compability is *not* guaranteed, updating your world might cause small and
big bugs (such as “missing node” errors or even crashes).
2017-02-08 18:17:11 +01:00
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
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
2017-09-14 03:52:39 +02:00
* 28 biomes
* The Nether, a fiery underworld in another dimension
2017-02-08 18:17:11 +01:00
* Redstone circuits (partially): Redstone ore, redstone, redstone repeater, levers, buttons, redstone blocks, redstone lamps
* Minecarts (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
2017-07-25 23:18:22 +02:00
* Slime block (does not interact with redstone)
* 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
* Bookshelves (deco only)
* Writable books
* A few server commands
2017-02-08 18:17:11 +01:00
* And more!
The following features are incomplete:
2017-02-10 17:24:33 +01:00
2017-09-14 03:52:39 +02:00
* Generated structures
2017-07-06 15:46:15 +02:00
* NPCs
* Some monsters and animals
2017-09-14 03:52:39 +02:00
* Redstone-related things
2017-02-08 18:17:11 +01:00
* The End
* Enchanting
* Experience
* Status effects
* Brewing, potions, tipped arrows
* Anvil
* A couple of non-trivial blocks and items
2017-05-14 23:02:36 +02:00
Bonus features (not found in Minecraft 1.11):
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
2017-03-20 22:27:24 +01: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
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)
2017-02-08 18:17:11 +01:00
* Still very, 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)
* Free software (“free” as in freedom *and* free beer)
2015-07-03 07:24:21 +02:00
2017-02-17 17:13:50 +01:00
## Reporting bugs
2017-07-25 23:18:22 +02:00
Please report all bugs and missing Minecraft features here:
2017-02-17 17:13:50 +01:00
<https://github.com/Wuzzy2/MineClone2-Bugs>
2017-02-17 17:13:50 +01:00
2017-02-12 22:02:50 +01:00
## 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
2017-02-22 00:23:32 +01:00
* `API.md`: For Minetest modders who want to mod this game
2017-02-12 22:02:50 +01:00
2017-01-16 01:24:55 +01:00
## Credits
2017-07-27 17:14:11 +02:00
There are so many people to list (sorry). Check out the respective mod directories for details. This section is only a rough overview of the core authors of this game.
2017-02-08 18:17:11 +01:00
2017-07-27 17:14:11 +02:00
### Coding
* [Wuzzy](https://forum.minetest.net/memberlist.php?mode=viewprofile&u=3082): Main programmer of most mods
* daredevils: Creator of MineClone on which MineClone 2 is based on
2017-08-28 02:09:57 +02:00
* [ex-bart](https://github.com/ex-bart): Redstone comparators
2017-07-27 17:14:11 +02:00
* Lots of other people: TO BE WRITTEN (see mod directories for details)
### Textures
* [XSSheep](http://www.minecraftforum.net/members/XSSheep): Main author; creator of the Pixel Perfection resource pack of Minecraft 1.11
* [Wuzzy](https://forum.minetest.net/memberlist.php?mode=viewprofile&u=3082): Main menu imagery and various edits and additions of texture pack
* [kingoscargames](https://github.com/kingoscargames): Various edits and additions of existing textures
* [leorockway](https://github.com/leorockway): Some edits of mob textures
* [xMrVizzy](https://minecraft.curseforge.com/members/xMrVizzy): Glazed terracotta (textures are subject to be replaced later)
* Other authors: GUI images,
### Models
* [22i](https://github.com/22i): Creator of all models
2017-08-08 18:51:45 +02:00
* [tobyplowy](https://github.com/tobyplowy): UV-mapping fixes to said models
2017-07-27 17:14:11 +02:00
### Sounds and music
Various sources. See the respective mod directories for details.
2015-06-29 19:53:39 +02:00
2017-01-16 01:24:55 +01:00
### Special thanks
2015-06-29 19:53:39 +02:00
2017-07-27 17:14:11 +02:00
* daredevils for starting MineClone, the original version of this game
2017-01-16 01:24:55 +01:00
* celeron55 for creating Minetest
2017-02-08 18:17:11 +01:00
* 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
2017-07-25 23:18:22 +02:00
* The workaholics who spent way too much time writing for the Minecraft Wiki. It's an invaluable resource for creating this game
* Notch and Jeb for being the major forces behind Minecraft
* XSSheep for creating the Pixel Perfection resource pack
2017-07-27 17:14:11 +02:00
* [22i](https://github.com/22i) for providing great models and support
2017-08-21 22:35:17 +02:00
* [maikerumine](http://github.com/maikerumine) for kicking off mobs and biomes
2015-06-29 19:53:39 +02:00
2017-01-16 01:24:55 +01:00
## Info for programmers
2017-02-22 00:23:32 +01:00
You find interesting and useful infos in `API.md`.
2017-01-16 01:24:55 +01:00
This project is currently mostly a one-person project.
2015-06-29 19:53:39 +02:00
2017-01-16 01:24:55 +01:00
## Legal information
This is a fan game, not developed or endorsed by Mojang AB.
2017-01-16 01:24:55 +01:00
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
2017-08-04 21:25:29 +02:00
MineClone 2 is a clean-room implementation of Minecraft
and licensed under the
GNU LGPL v2.1 (Wuzzy, daredevils and countless others) (see `LICENSE.txt`).
MineClone 2 is a direct continuation of the discontinued MineClone
project by daredevils which fell under the same license.
2017-01-16 01:24:55 +01:00
Mods credit:
2017-02-10 17:24:33 +01:00
See `README.txt` or `README.md` in each mod directory for information about other authors.
2015-06-29 19:53:39 +02:00
2017-01-16 01:24:55 +01:00
### License of media (textures and sounds)
2017-07-21 01:56:51 +02:00
No non-free licenses are used anywhere.
The textures, unless otherwise noted, are based on the Pixel Perfection resource pack for Minecraft 1.11,
authored by XSSheep. Most textures are verbatim copies, while some textures have been changed or redone
from scratch.
Source: <https://www.planetminecraft.com/texture_pack/131pixel-perfection/>
2017-07-27 17:14:11 +02:00
License: [CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/)
2017-07-21 01:56:51 +02:00
2017-07-21 23:13:09 +02:00
MineClone 2 is currently in the processs of changing all the textures.
The textures for the glazed terracotta come from Faithful Vanilla.
(authored by Vattic, xMrVizzy and many others).
Source: <https://minecraft.curseforge.com/projects/faithful-vanilla>
2017-07-06 15:46:15 +02:00
2017-01-16 01:24:55 +01:00
License of all main menu images: WTFPL
2017-03-09 02:29:16 +01:00
All other files, unless mentioned otherwise, fall under:
2017-07-22 15:10:20 +02:00
Attribution-ShareAlike 3.0 Unported (CC BY-SA 4.0)
http://creativecommons.org/licenses/by-sa/4.0/
2017-07-06 15:46:15 +02:00
See README.txt in each mod directory for detailed information about other authors.