# The VoxeLibre Wiki A Wiki for VoxeLibre # VoxeLibre **VoxeLibre** is a game inspired by Minecraft for [Luanti](https://www.luanti.org). Forked from MineClone by davedevils. Developed by many people, see [Credits](https://git.minetest.land/VoxeLibre/VoxeLibre/src/branch/master/CREDITS.md) for a complete list. ### Contents This Wiki is in development. As there are only a few people working on it, it will probably a longterm project. If you are interested to help, you are welcome! Main contents of this Wiki: - Introduction with some info about contents and gameplay (you are on this page) - [**Basic Elements**](https://wiki.mavori.ch//books/the-voxelibre-wiki/chapter/basic-elements "Basic Elements"): The main elements of VoxeLibre (and other voxel games) - [**Installation**](https://wiki.mavori.ch//books/the-voxelibre-wiki/chapter/installation "Installation"): Basic info to start with Luanti, VoxeLibre and running a server - [**Mods**](https://wiki.mavori.ch//books/the-voxelibre-wiki/chapter/mods "Mods"): Extend the functionality of VoxeLibre - [**Additional topics**](https://wiki.mavori.ch//books/the-voxelibre-wiki/chapter/additional-topics "Additional Topics"): Other aspects of VoxeLibre covered in this Wiki ### 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. There is no goal. It's a sandbox game, you build your game within the existing world. You survive by fighting against hostile [Mobs](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/mobs "Mobs") and hunger. You collect items using different tools or mine for ores and other treasures. Start farming using seeds or vegetables and harvest to eat and trade. You gain experience by killing monsters, mining ores or trading with villagers and can use your experience to [enchant](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/enchanting "Enchant (page does not exist)") tools and weapons. Build your own world with collected or crafted blocks – the only limit is your imagination! Build a railway system and have fun with minecarts. Redstone circuits allow complex mechanics. Play in creative mode, if you just want to build and create, without disturbances from hostile mobs. [Dimensions](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/dimensions "Dimensions") The realms accessible within VoxeLibre. There are three dimensions: The overworld, the nether and the end. [Biomes](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/biomes "Biomes") The biomes, that build the world. [Blocks](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/blocks "Blocks") Info on the various blocks that make up the biomes/world. [Items](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/items "Items") Info about the various items that players can collect and use. [Mobs](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/mobs "Mobs") Info about the various creatures (friendly and hostile) found in VoxeLibre. [Enchanting](https://wiki.mavori.ch//books/the-voxelibre-wiki/page/enchanting "Enchanting") Info about the enchanting process to enhance abilities of items, tools and weapons. # Installation # Mods Basics will cover just some basic aspects of mod structure to help as starting point for mod development. The specific mods will focus on some specific mods, part of them directly accessible with VoxeLibre, others only usable with some adaptations. # Basics Mods have in Luanti a multiple meaning. Luanti itself is working with mods (modules) as functional entities written in Lua. A game runninng in Luanti is a combination of several mods. And the functionality of a game can be extended with additional mods in the more common sense of the word (modification). To be used, a Mod has to be activated in the world.mt of the game world used. Add simply a line with ``` load_mod_ = true ``` and start the game. The mod will now be loaded automatically. Mods can be stored in several locations. Each mod has his own directory to store Lua code, textures, models and sounds. Luanti checks three locations for mods while starting. <minetest> is the user-data directory.
1. Game mods Mods that build the game running the world. They are placed in the folder of the game. ``` minetest/games/VoxeLibre/mods/ ```
2. Global mods Global mods are placed in the top level and are the place, where mods are placed to be used in several worlds ``` minetest/mods/ ```
3. World mods Mods located in a specific world, affecting and to be loaded only, if this world is used in a game. ``` minetest/worlds/world/worldmods/ ```
Luanti checks each of those locations in order. If you place a mod with the same name in the worldmods folder, it will overwrite the mod previously loaded in the game mods folder. ### Basic structure of a mod The basic structure of a mod is quite simple. It consists of an configuration file and the basic lua code of the mod. ``` mymod ├── init.lua └── mod.conf ``` Textures, models and sound can be placed in the same folder, but is good practice to place them in subfolder of the mod. ``` mymod ├── textures │   └── mymod_node.png files ├── init.lua └── mod.conf ``` # Specific Mods # Tutorials # Additional Topics # Height of clouds Clouds are very low, if you tend to build sky towers or high builds like the Mont Saint Michel in my world. It is possible to change the height level of the clouds directly in the VoxeLibre game folder. But be aware, this will be overwritten with the next update ... in mods/CORE/mcl\_worlds/init.lua, line 168 set ``` height = mcl_worlds.layer_to_y(127), ``` to the level you prefer for clouds. I use a value of 188 right now. # Mapserver Mapserver is an additional software which can easily be installed on the same server where Luanti is running. You find detailed instructions about the installation on [github](https://github.com/minetest-mapserver/mapserver). Starting the mapserver the first time will initiate the initial rendering. Depending on the size of the map, this can take some time (on my 8 GB server about 3 days ...). After the initial rendering, mapserver switches to incremental rendering: each change will be implemented in the map within a short delay. To be able to add additional infos, as e.g. POI, train lines a.o., you should install the companion [mapserver\_mod](https://content.luanti.org/packages/BuckarooBanzay/mapserver/). As described on the github page, you can chose between the passive and the active mode. With active mode, you have more real time data displayed on the map (number of players a.o.). To start the active mode, you have to add those lines of code into luanti.conf: ```lua mapserver.enable_crafting = true secure.http_mods = mapserver mapserver.url = http://[ip of your server]:8080 mapserver.key = [secret]