{"id":13441503,"url":"https://github.com/freeminer/freeminer","last_synced_at":"2026-03-15T04:03:34.301Z","repository":{"id":12137963,"uuid":"14730563","full_name":"freeminer/freeminer","owner":"freeminer","description":"Freeminer is an open source sandbox game inspired by Minecraft.","archived":false,"fork":false,"pushed_at":"2024-10-26T02:48:43.000Z","size":116650,"stargazers_count":399,"open_issues_count":63,"forks_count":88,"subscribers_count":43,"default_branch":"master","last_synced_at":"2024-10-26T07:35:08.908Z","etag":null,"topics":["game","minecraft"],"latest_commit_sha":null,"homepage":"http://freeminer.org/","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"mrbatista/loopback-connector-arangodb","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/freeminer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-11-26T22:06:31.000Z","updated_at":"2024-10-26T02:48:46.000Z","dependencies_parsed_at":"2023-12-06T02:58:04.515Z","dependency_job_id":"21cde46b-9323-48d6-80ba-3f4dcdb63d3b","html_url":"https://github.com/freeminer/freeminer","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeminer%2Ffreeminer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeminer%2Ffreeminer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeminer%2Ffreeminer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeminer%2Ffreeminer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/freeminer","download_url":"https://codeload.github.com/freeminer/freeminer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221760017,"owners_count":16876337,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","minecraft"],"created_at":"2024-07-31T03:01:34.809Z","updated_at":"2026-03-15T04:03:34.281Z","avatar_url":"https://github.com/freeminer.png","language":"C++","funding_links":[],"categories":["C++","Sandbox","Native"],"sub_categories":["Sandbox"],"readme":"# Freeminer\n\n[![Build Status](https://img.shields.io/travis/freeminer/freeminer.svg?style=flat-square)](https://travis-ci.org/freeminer/freeminer) [![Latest Stable Version](https://img.shields.io/github/release/freeminer/freeminer.svg?style=flat-square\u0026label=stable)](https://github.com/freeminer/freeminer/releases/latest) [![Total Downloads](https://img.shields.io/github/downloads/freeminer/freeminer/latest/total.svg?style=flat-square)](https://github.com/freeminer/freeminer/releases) [![License](https://img.shields.io/github/license/freeminer/freeminer.svg?style=flat-square)](https://raw.githubusercontent.com/freeminer/freeminer/master/COPYING)\n\nFreeminer is an open source sandbox game inspired by [Minecraft](https://minecraft.net/).\n\nFreeminer is based on Minetest which is developed by a [number of contributors](https://github.com/minetest/minetest/graphs/contributors) from all over the globe.\n\nIt aims to make the game fun while trading off some bits of perfectionism.\n\n## Installing\n- **Android**:\n\t* Google Play - https://play.google.com/store/apps/details?id=org.freeminer.freeminer\n\t* F-droid - https://f-droid.org/repository/browse/?fdid=org.freeminer.freeminer\n- **Windows**: https://github.com/freeminer/freeminer/releases\n- **Ubuntu**: Install http://www.ubuntuupdates.org/ppa/getdeb_games and run:\n\n\t```sh\n\tsudo apt-get install freeminer\n\t```\n- **Arch Linux**:\n\n\t```sh\n\tyaourt -S freeminer\n\t```\n\t\u003csup\u003e*Stable version*\u003c/sup\u003e\n\t\n\t```sh\n\tyaourt -S freeminer-git\n\t```\n\t\u003csup\u003e*Development version*\u003c/sup\u003e\n\t\n- **FreeBSD**:\n\n\t```sh\n\tcd /usr/ports/games/freeminer-default \u0026\u0026 sudo make install clean\n\t```\n\n- **openSUSE**: https://software.opensuse.org/package/freeminer\n\n## Further documentation\n- Website: http://freeminer.org/\n- Forums: http://forum.freeminer.org/\n\n## Default controls\n- `W` `A` `S` `D`: move\n- `Space`: jump/climb\n- `Shift`: sneak/go down\n- `Q`: drop item\n- `I`: inventory\n- Mouse: turn/look\n- Mouse left: dig/punch\n- Mouse right: place/use\n- Mouse wheel: select item\n- `Esc`: pause menu\n- `T`: chat\n- `Z`: zoom\n- `Tab`: player list\n- `~`: toggle console\n\n## Compiling\nInstall dependencies. Here's an example for\n\nDebian/Ubuntu:\n```sh\nsudo apt-get install build-essential libirrlicht-dev cmake libbz2-dev libgettextpo0 \\\nlibsqlite3-dev libleveldb-dev libsnappy-dev libcurl4-openssl-dev libluajit-5.1-dev libgmp-dev libspatialindex-dev libboost-system-dev \\\nlibpng12-dev libjpeg-dev libfreetype6-dev libxxf86vm-dev libgl1-mesa-dev libvorbis-dev libopenal-dev\n# First  - needed always\n# Second - recommended for servers and singleplayer\n# Third  - needed for client only\n\n# optional:\nsudo apt-get install libhiredis-dev cmake-curses-gui\n```\n___\nFedora:\n```sh\n# the first five is the closest to Debian/Ubuntu build-essential\nsudo yum install make automake gcc gcc-c++ kernel-devel cmake \\\nirrlicht-devel bzip2-libs libpng-devel libjpeg-turbo-devel freetype-devel \\\nlibXxf86vm-devel mesa-libGL-devel sqlite-devel libvorbis-devel \\\nopenal-soft-devel libcurl-devel luajit-devel leveldb-devel snappy-devel \\\ngettext-devel msgpack msgpack-devel spatialindex-devel bzip2-devel\n```\n___\nArch Linux:\n```sh\nsudo pacman -S curl irrlicht leveldb libvorbis luajit openal sqlite cmake msgpack-c freetype2\n```\n___\nGentoo/Funtoo:\n```sh\nemerge -av media-libs/libvorbis media-libs/openal dev-games/irrlicht \\\ndev-libs/msgpack dev-libs/leveldb sci-libs/libspatialindex\n```\n___\nOS X:\n```sh\nbrew install cmake freetype gettext hiredis irrlicht jpeg leveldb libogg \\\nlibvorbis luajit msgpack\n```\n\n\u003csup\u003eRecommended irrlicht version: `1.8.2`\u003c/sup\u003e\n\nDownload source code:\n```sh\ngit clone --recursive https://github.com/freeminer/freeminer.git\ncd freeminer\n```\n\n\u003csup\u003eRecommended minimum compiler version: `gcc 4.8` or `clang 3.3`\u003c/sup\u003e\n\nBuild it (GNU/Linux):\n```sh\nmkdir -p build \u0026\u0026 cd build\ncmake ..\nnice make -j $(nproc || sysctl -n hw.ncpu || echo 2)\n```\n\nor for debian based:\n```sh\ncurl https://raw.githubusercontent.com/freeminer/freeminer/master/build_tools/build.sh | sh\n```\n\nBuild it (OS X):\n```sh\nmkdir _build \u0026\u0026 cd _build\ncmake .. -DGETTEXT_LIBRARY=/usr/local/opt/gettext/lib/libgettextlib.dylib -DGETTEXT_INCLUDE_DIR=/usr/local/opt/gettext/include\nmake -j8 package\n```\n(if the make command doesn't work on OS X install bsdmake)\n\nBuild it (windows):\n\n[vs2013](build/windows_vs2015)\n\n[vs2015](build/windows)\n\n\nPlay it!\n```\ncd ..\nbin/freeminer\n```\n\n\n\n\n\nLuanti (formerly Minetest)\n==========================\n\n![Build Status](https://github.com/luanti-org/luanti/workflows/build/badge.svg)\n[![Translation status](https://hosted.weblate.org/widgets/minetest/-/svg-badge.svg)](https://hosted.weblate.org/engage/minetest/?utm_source=widget)\n[![License](https://img.shields.io/badge/license-LGPLv2.1%2B-blue.svg)](https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html)\n\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"textures/base/pack/logo.png\" width=\"32%\"\u003e\n    \u003ch1\u003eLuanti (formerly Minetest)\u003c/h1\u003e\n    \u003cimg src=\"https://github.com/luanti-org/luanti/workflows/build/badge.svg\" alt=\"Build Status\"\u003e\n    \u003ca href=\"https://hosted.weblate.org/engage/minetest/?utm_source=widget\"\u003e\u003cimg src=\"https://hosted.weblate.org/widgets/minetest/-/svg-badge.svg\" alt=\"Translation status\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-LGPLv2.1%2B-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\nLuanti is a free open-source voxel game engine with easy modding and game creation.\n\nCopyright (C) 2010-2025 Perttu Ahola \u003cceleron55@gmail.com\u003e\nand contributors (see source file comments and the version control log)\n\nTable of Contents\n------------------\n\n1. [Further Documentation](#further-documentation)\n2. [Default Controls](#default-controls)\n3. [Paths](#paths)\n4. [Configuration File](#configuration-file)\n5. [Command-line Options](#command-line-options)\n6. [Compiling](#compiling)\n7. [Docker](#docker)\n8. [Version Scheme](#version-scheme)\n\n\nFurther documentation\n----------------------\n- Website: https://www.luanti.org/\n- Luanti Documentation: https://docs.luanti.org/\n- Forum: https://forum.luanti.org/\n- GitHub: https://github.com/luanti-org/luanti/\n- [Developer documentation](doc/developing/)\n- [doc/](doc/) directory of source distribution\n\nDefault controls\n----------------\nAll controls are re-bindable using settings.\nSome can be changed in the key config dialog in the settings tab.\n\n| Button                        | Action                                                         |\n|-------------------------------|----------------------------------------------------------------|\n| Move mouse                    | Look around                                                    |\n| W, A, S, D                    | Move                                                           |\n| Space                         | Jump/move up                                                   |\n| Shift                         | Sneak/move down                                                |\n| Q                             | Drop itemstack                                                 |\n| Shift + Q                     | Drop single item                                               |\n| Left mouse button             | Dig/punch/use                                                  |\n| Right mouse button            | Place/use                                                      |\n| Shift + right mouse button    | Build (without using)                                          |\n| I                             | Inventory menu                                                 |\n| Mouse wheel                   | Select item                                                    |\n| 0-9                           | Select item                                                    |\n| Z                             | Zoom (needs zoom privilege)                                    |\n| T                             | Chat                                                           |\n| /                             | Command                                                        |\n| Esc                           | Pause menu/abort/exit (pauses only singleplayer game)          |\n| Shift + Esc                   | Exit directly to main menu from anywhere, bypassing pause menu |\n| +                             | Increase view range                                            |\n| -                             | Decrease view range                                            |\n| K                             | Enable/disable fly mode (needs fly privilege)                  |\n| J                             | Enable/disable fast mode (needs fast privilege)                |\n| H                             | Enable/disable noclip mode (needs noclip privilege)            |\n| E                             | Aux1 (Move fast in fast mode. Games may add special features)  |\n| C                             | Cycle through camera modes                                     |\n| V                             | Cycle through minimap modes                                    |\n| Shift + V                     | Change minimap orientation                                     |\n| F1                            | Hide/show HUD                                                  |\n| F2                            | Hide/show chat                                                 |\n| F3                            | Disable/enable fog                                             |\n| F4                            | Disable/enable camera update (Mapblocks are not updated anymore when disabled, disabled in release builds)  |\n| F5                            | Cycle through debug information screens                        |\n| F6                            | Cycle through profiler info screens                            |\n| F10                           | Show/hide console                                              |\n| F12                           | Take screenshot                                                |\n\nPaths\n-----\nLocations:\n\n* `bin`   - Compiled binaries\n* `share` - Distributed read-only data\n* `user`  - User-created modifiable data\n\nWhere each location is on each platform:\n\n* Windows .zip / RUN_IN_PLACE source:\n    * `bin`   = `bin`\n    * `share` = `.`\n    * `user`  = `.`\n* Windows installed:\n    * `bin`   = `C:\\Program Files\\Minetest\\bin (Depends on the install location)`\n    * `share` = `C:\\Program Files\\Minetest (Depends on the install location)`\n    * `user`  = `%APPDATA%\\Minetest` or `%MINETEST_USER_PATH%`\n* Linux installed:\n    * `bin`   = `/usr/bin`\n    * `share` = `/usr/share/minetest`\n    * `user`  = `~/.minetest` or `$MINETEST_USER_PATH`\n* macOS:\n    * `bin`   = `Contents/MacOS`\n    * `share` = `Contents/Resources`\n    * `user`  = `Contents/User` or `~/Library/Application Support/minetest` or `$MINETEST_USER_PATH`\n\nWorlds can be found as separate folders in: `user/worlds/`\n\nConfiguration file\n------------------\n- Default location:\n    `user/minetest.conf`\n- This file is created by closing Luanti for the first time.\n- A specific file can be specified on the command line:\n    `--config \u003cpath-to-file\u003e`\n- A run-in-place build will look for the configuration file in\n    `location_of_exe/../minetest.conf` and also `location_of_exe/../../minetest.conf`\n\nCommand-line options\n--------------------\n- Use `--help`\n\nCompiling\n---------\n\n- [Compiling - common information](doc/compiling/README.md)\n- [Compiling on GNU/Linux](doc/compiling/linux.md)\n- [Compiling on Windows](doc/compiling/windows.md)\n- [Compiling on MacOS](doc/compiling/macos.md)\n\nDocker\n------\n\n- [Developing minetestserver with Docker](doc/developing/docker.md)\n- [Running a server with Docker](doc/docker_server.md)\n\nVersion scheme\n--------------\nWe use `major.minor.patch` since 5.0.0-dev. Prior to that we used `0.major.minor`.\n\n- Major is incremented when the release contains breaking changes, all other\nnumbers are set to 0.\n- Minor is incremented when the release contains new non-breaking features,\npatch is set to 0.\n- Patch is incremented when the release only contains bugfixes and very\nminor/trivial features considered necessary.\n\nSince 5.0.0-dev and 0.4.17-dev, the dev notation refers to the next release,\ni.e.: 5.0.0-dev is the development version leading to 5.0.0.\nPrior to that we used `previous_version-dev`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreeminer%2Ffreeminer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffreeminer%2Ffreeminer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffreeminer%2Ffreeminer/lists"}