cuberite / android

Official Android app for Cuberite

Cuberite

Cuberite is a Minecraft-compatible multiplayer game server that is written in C++ and designed to be efficient with memory and CPU, as well as having a flexible Lua Plugin API. Cuberite is compatible with the Java Edition Minecraft client.

Cuberite runs on Windows, *nix and Android operating systems. This includes Android phones and tablets as well as Raspberry Pis; support for small embedded devices is experimental.

Currently we support Release 1.8 - 1.12.2 Minecraft protocol versions.

Subscribe to the newsletter for important updates and project news.

Installation

There are several ways to obtain Cuberite.

Binaries

• The easiest method is downloading for Windows or Linux from the website.
• You can use the EasyInstall script for Linux and macOS, which automatically downloads the correct binary. The script is described below.

The EasyInstall script

This script will download the correct binary from the project site.

curl -sSfL https://download.cuberite.org | sh

Compiling

• You can compile automatically for Linux, macOS and FreeBSD with the compile.sh script. The script is described below.
• You can also compile manually. See COMPILING.md.

Compiling may provide better performance (1.5-3x as fast) and it supports more operating systems.

The compile.sh script

This script downloads the source code and compiles it. The script is smart enough to notify you of missing dependencies and instructing you on how to install them. The script doesn't work for Windows.

Using curl:

sh -c "$(curl -sSfL -o - https://compile.cuberite.org)"

Or using wget:

sh -c "$(wget -O - https://compile.cuberite.org)"

Hosted services

• Hosted Cuberite is available via Gamocosm.

Contributing

Cuberite is licensed under the Apache License V2, and we welcome anybody to fork and submit a Pull Request back with their changes, and if you want to join as a permanent member we can add you to the team.

Cuberite is developed in C++ and Lua. To contribute code, please check out GETTING-STARTED.md and CONTRIBUTING.md for more details.

Plugins are written in Lua. You can contribute by developing plugins and submitting them to the plugin repository or the forum. Please check out our plugin introduction guide for more info.

If you are not a programmer, you can help by testing Cuberite and reporting bugs. See TESTING.md for details.

You can also help with documentation by contributing to the User's Manual.

Other Stuff

For other stuff, check out the homepage, the Users' Manual, the forums, and the Plugin API.

Support the Cuberite development team on Liberapay

android's Issues

Choose external storage as server location

Currently you can only install Cuberite in the internal storage. I don't speak for everybody, but I'm pretty sure people will likely want to have their server on their SD card due to storage limitations. I think it would be great if we were able to do so.

Can't connect to server from desktop, or even access the webadmin from Xiaomi phone which is hosting

As title says, I can't connect to Cuberite from PC, or even access WebAdmin using:
Settings -> Open Webadmin

But it seems that server is running (I see default minecraft server output in Console).
My phone is Xiaomi Mi6, Android 9 with MIUI 11. I suspect there is some permission denied anywhere in port binding, but not so many people host servers on their phones and I assume it's hard to find an answer on stack / reddit.

zh_CN translate a file

{
"%d new notification"
"%d 条新通知"
}
{
"%d new notifications"
"%d 条新通知"
}
{
"Navigate home"
"回到首页"
}
{
"Navigate up"
"返回上一页"
}
{
"More options"
"更多设置"
}
{
"Done"
"完成"
}
{
"See all"
"查看全部"
}
{
"Choose an app"
"选择一个应用"
}
{
"Alt+"
"Alt +"
}
{
"Ctrl+"
"Ctrl +"
}
{
"delete"
"删除"
}
{
"enter"
"输入"
}
{
"Function+"
"功能+"
}
{
"Meta+"
"元+"
}
{
"Shift+"
"Shift +"
}
{
"space"
"空间"
}
{
"Sym+"
"象征+"
}
{
"Menu+"
"菜单+"
}
{
"Search…"
"搜索..."
}
{
"Clear query"
"清除查询"
}
{
"Search query"
"清除搜索"
}
{
"Search"
"搜索"
}
{
"Submit query"
"提交查询"
}
{
"Voice search"
"声音搜索"
}
{
"Share with"
"和。。分享"
}
{
"Share with %s"
"与 %s 分享"
}
{
"Characters entered %1$d of %2$d"
"输入了 %1$d 个字符，共 %2$d 个"
}
{
"Character limit exceeded %1$d of %2$d"
"字符数超出了 %1$d 的 %2$d"
}
{
"Chip text"
"芯片文字"
}
{
"Clear text"
"清除文字"
}
{
"Copy"
"复制"
}
{
"disabled"
"已关闭"
}
{
"Execute"
"执行"
}
{
"Install Cuberite"
"安装Cuberite"
}
{
"Kill Server\n(If stopping doesn't work)"
"杀死服务器\n（如果停止不起作用）"
}
{
"Control"
"开关"
}
{
"Settings"
"设置"
}
{
"Start Server"
"启动服务器"
}
{
"Stop Server"
"停止服务器"
}
{
"enabled"
"已启用"
}
{
"Error"
"错误"
}
{
"Advanced"
"高级"
}
{
"Show dropdown menu"
"显示下拉菜单"
}
{
"Dialog Icon"
"对话框图标"
}
{
"License for the [ini4j] library (used for manipulating Cuberite settings)"
"[ini4j]Libraries的许可证（用于操纵Cuberite设置）"
}
{
"Copyright 2005,2009 Ivan SZKIBA\n\n Licensed under the Apache License, Version 2.0 (the License); you may not use this file except in compliance with the License. You may obtain a copy of the License at\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an AS IS BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License."
"版权所有2005,2009 Ivan SZKIBA\n\n 根据Apache许可证2.0版（以下简称“许可证”）获得许可；除非遵守许可，否则不得使用此文件。您可以在以下位置获得许可的副本：\n\n http://www.apache.org/licenses/LICENSE-2.0\n\n 除非适用法律要求或以书面形式达成协议，否则根据许可协议分发的软件将按原样分发，没有任何明示或暗示的保证或条件。有关许可下特定的语言管理权限和限制，请参见许可。"
}
{
"Enter commands…"
"输入命令..."
}
{
"This service downloads, unzips and installs Cuberite."
"该服务下载，解压缩并安装Cuberite。"
}
{
"Cuberite stores its worlds on the external storage by default, which is readable and writable by any app. For this, you need to allow Cuberite to write to the external storage. If you don't want to give the necessary permission, please select the "Deny" option and Cuberite will use the app's private storage."
"默认情况下，Cuberite将其世界存储在外部存储中，任何应用均可读取和写入。为此，您需要允许Cuberite写入外部存储。如果您不想授予必要的权限，请选择“拒绝”，Cuberite将使用该应用的私有存储"
}
{
"New notification"
"新通知"
}
{
"Remove %1$s"
"删除 %1$s"
}
{
"Change to next month"
"更改为下个月"
}
{
"Change to previous month"
"更改为上个月"
}
{
"Current selection: %1$s"
"当前选择: %1$s"
}
{
"Select a Date"
"选择日期"
}
{
"Selected date"
"选定日期"
}
{
"Column of days: %1$s"
"天列：%1$s"
}
{
"Invalid format."
"无效的格式."
}
{
"Example: %1$s"
"示例: %1$s"
}
{
"Use: %1$s"
"使用：%1$s"
}
{
"Invalid range."
"范围无效."
}
{
"Navigate to year %1$s"
"跳转至 %1$s 年"
}
{
"Out of range: %1$s"
"超出范围：%1$s"
}
{
"Start date – %1$s"
"开始日期–%1$s"
}
{
"%1$s – End date"
"%1$s –结束日期"
}
{
"Select a Date Range"
"选择日期范围"
}
{
"Start date – End date"
"开始日期–结束日期"
}
{
"Save"
"保存"
}
{
"Date"
"日期"
}
{
"End date"
"结束日期"
}
{
"Start date"
"开始日期"
}
{
"Switch to calendar input mode"
"切换到日历输入模式"
}
{
"Tap to switch to selecting a day"
"点按即可切换到选择日期"
}
{
"Switch to text input mode"
"切换到文字输入模式"
}
{
"Tap to switch to selecting a year"
"点按即可切换到选择年份"
}
{
"%1$s to %2$s"
"%1$s 到 %2$s"
}
{
"Not set"
"没有设置"
}
{
"Cuberite is running!"
"Cuberite正在运行！"
}
{
"Password"
"密码"
}
{
"Show password"
"显示密码"
}
{
""%1$s" copied to clipboard."
""%1$s" 已复制到剪贴板。"
}
{
"This service runs Cuberite and ensures that it is not killed by the system."
"该服务运行Cuberite，并确保它不会被系统杀死。"
}
{
"If you have troubles connecting to Cuberite and get the message "Failed to authenticate!", you might want to disable authentication."
"如果在连接Cuberite时遇到问题，并收到“无法通过身份验证！”，可以禁用身份验证"
}
{
"Authentication"
"认证方式"
}
{
"Something went wrong while accessing the Server configuration"
"访问服务器配置时出了点问题"
}
{
"Success! Authentication is now %1$s! Restart the server to activate the change"
"成功！身份验证现在为 %1$s！重新启动服务器以激活更改"
}
{
"Debug information"
"调试信息"
}
{
"Information"
"信息"
}
{
"Third-party Libraries"
"第三方Libraries"
}
{
"Version %1$s"
"版本 %1$s "
}
{
"Install zip files manually"
"手动安装zip文件"
}
{
"Required ABI for your device: %1$s"
"设备所需的ABI：%1$s"
}
{
"Instead of downloading Cuberite you can choose to use your own compiled binaries. Use this only if you understand what you are doing."
"您可以使用自己编译的Libraries文件，无需下载Cuberite"
}
{
"Select and install binary zip file"
"选择并安装Libraries文件"
}
{
"Select and install server.zip"
"选择并安装server.zip"
}
{
"Perform Cuberite update"
"执行Cuberite更新"
}
{
"Download and install Cuberite binary"
"下载并安装Libraries文件"
}
{
"Use this section from time to time to update your installation of Cuberite. Please note that if you perform a server.zip update this may overwrite custom server settings."
"使用以下选项来更新您的Cuberite\n注意，执行server.zip更新，可能会覆盖服务器设置"
}
{
"Download and install server.zip"
"下载并安装server.zip"
}
{
"Start Cuberite automatically when you boot up your device"
"启动设备时自动启动Cuberite"
}
{
"Start Cuberite on boot"
"在启动时启动Cuberite"
}
{
"Theme"
"主题"
}
{
"Automatic"
"自动"
}
{
"Choose theme"
"选择主题"
}
{
"Dark"
"黑色"
}
{
"Light"
"白色"
}
{
"Troubleshooting"
"故障排除"
}
{
"Cuberite needs to be installed before setting the Webadmin credentials"
"设置Webadmin之前需要安装Cuberite"
}
{
"For fine-tuning your server, you are entitled to use the built-in Webadmin. Use the settings here to set a username and password for it"
"为了对服务器进行微调，您可以使用内置的Webadmin\n使用此处的设置为其设置用户名和密码"
}
{
"Webadmin"
"网络管理员"
}
{
"Change login credentials"
"更改登录凭证"
}
{
"Cuberite needs to be running before you can access the Webadmin"
"您需要先运行Cuberite，然后才能访问Webadmin"
}
{
"Open Webadmin"
"开启Webadmin"
}
{
"Success! The new credentials are activated the next time you start Cuberite"
"成功！下次启动Cuberite时，将激活新的凭证"
}
{
"Downloading Cuberite…"
"正在下载Cuberite…"
}
{
"Cuberite failed to start. Ensure that your binary has the following ABI: %1$s"
"Cuberite无法启动。确保您的Libraries具有以下ABI: %1$s"
}
{
"Successfully installed Cuberite!"
"成功安装Cuberite！"
}
{
"Installing Cuberite…"
"正在安装Cuberite…"
}
{
"No filemanager found: Please install one"
"找不到文件管理器"
}
{
"Permissions needed"
"需要权限"
}
{
"SHA-1 validation error"
"SHA-1验证错误"
}
{
"Failed to unzip the server files"
"无法解压缩服务器文件"
}
{
"Please stop the server before updating the binary"
"请先停止服务器，然后在更新Libraries"
}
{
"Username"
"用户名"
}
{
"OFF"
"关闭"
}
{
"ON"
"开启"
}
{
"Console"
"控制台"
}

Connection problem

Is it possible to use public IP to create a server?

Add a .nomedia file in /sdcard/cuberite-server after installation

This will prevent webadmin assets being scanned by the system media scanner

"Timed Out" error when trying to connect to Minecraft Server 1.12.2 on Android 5.1.1 Cuberite

Hello,

This is a follow on from #70.

I am attempting to connect to my Minecraft server using version 1.12.2 on the IP address 172.20.10.11:8080.

When I added the server to Minecraft the first time it appeared correctly with the description "Cuberite - in C++!". When I tried to connect, it reported that it was "Logging In" and then gave the messaged "Timed Out".

I've since deleted and readded the server, as well as tried to do a 'direct connect', both of which report as "Logging In" and then gave the message "Timed Out". I've also restarted the server, both on the app and in the admin console at http://172.20.10.11:8080, as well as closing and reopening the app. I now cannot get the description of the server to appear in the menu which reports that it is "Pinging...", even after clicking "Refresh" and waiting multiple times. Sometimes it gives the message "Can't connect to server".

Neither the app console or the web console report that my Minecraft account has connected to the server.

The phone which is hosting a server (Samsung Galaxy J1 Mini) and my laptop are connected to the personal hotspot of an iPhone Xs Max.

I should note that the time on the Samsung does not match the laptop or iPhone.

Here is a copy of the 'console' page on the phone:

Cuberite is starting...
linker: /data/data/org.cuberite.android/files/Cuberite: unused DT entry: type 0x6ffffef5 arg 0x1cf4
linker: /data/data/org.cuberite.android/files/Cuberite: unused DT entry: type 0x6ffffffe arg 0x2830
linker: /data/data/org.cuberite.android/files/Cuberite: unused DT entry: type 0x6fffffff arg 0x3

[23:24:20] --- Started Log ---

[23:24:20] Cuberite local build (id: Unknown)
[23:24:20] from commit approx: 20d5cf0bfcea65f2ff1faf86dba2069932cbfb3f built at: approx: 2023-11-20 18:12:52 +0800
[23:24:20] Creating new server instance...

[23:24:20] Reading server config...

[23:24:20] Starting server...

[23:24:20] Compatible clients: 1.8.x-1.14.4
[23:24:20] WebServer: The server will run in unsecured HTTP mode.
[23:24:20] Put a valid HTTPS certificate in file 'webadmin/httpscert.crt' and its corresponding private key to 'webadmin/httpskey.pem' (without any password) to enable HTTPS support
[23:24:20] Loaded 789 crafting recipes
[23:24:20] Cannot open file "Protocol/1.13/base.recipes.txt", no recipe book recipes will be available!
[23:24:20] Cannot open file "Protocol/1.14.4/base.recipes.txt", no recipe book recipes will be available!

[23:24:20] Loaded 1.12.2 380 recipe book
[23:24:20] Loaded 67 furnace recipes and 66 fuels
[23:24:20] Loaded 49 brewing recipes
[23:24:20] Invalid biome ("BambooJungle") specified in AllowedBiomes in cubeset file Prefabs/SinglePieceStructures/JungleTemple.cubeset. Skipping the biome.
[23:24:20] Invalid biome ("BambooJungleHills") specified in AllowedBiomes in cubeset file Prefabs/SinglePieceStructures/JungleTemple.cubeset. Skipping the biome.
[23:24:20] -- Loading Plugins --
[23:24:21] [Core] Initialised!
[23:24:21] [ChatLog] Initialized ChatLog v.3
[23:24:21] -- Loaded 2 Plugins --

[23:24:22] Preparing spawn (world_nether): 11.11% (9/81; 7.56 chunks / sec)
[23:24:22] World "world_the_end": Did not find an acceptable spawnpoint. Generated a random spawnpoint position at {0, 66, 0}
[23:24:22] WebAdmin is running on port(s) 8080
[23:24:22] Startup complete, took 2551ms!

Install-button is overlapped

When using the app in landscape mode, the install-button is overlapped.

Repair the server depot

Since 2 months, the first install dépôt server was broken (ERROR 404). Thanks for your awesome work.

Message "Failed to extract server files" when trying to extract server.zip in Cuberite 1.6.0

Hello,

I am using a Samsung Galaxy J1 Mini (SM-J105Y). I have downloaded and installed the Cuberite 1.6.0 APK from F-Droid. When clicking the green circle "Install Cuberite" on the main page, a popup appears stating "Downloading Cuberite" with no progress (0 %). After approximately 30 seconds, I get the message "Failed to extract server files". I've instead downloaded 'armeabi-v7a.zip' (due to the ARMv7 architecture of the J1 Mini) and 'server.zip' directly to the phone from Jenkins.

Under 'Settings' > 'Install Cuberite manually', clicking 'Select Cuberite executable zip file' > 'armeabi-v7a.zip' gives the message "Successfully installed Cuberite!". If I click "Select server.zip file" and select "server.zip", I get the message "Failed to extract server files".

The debug information is:
Running on Android 5.1.1 (API Level 22)
Using ABI armeabi-v7a
IP: 172.20.10.11
Private directory: /data/data/org.cuberite.android/files
Public directory: /storage/emulated/0
Storage location: BLANK
Download URL: https://download.cuberite.org/androidbinaries/

I have 3.8 GB available in storage. I can also confirm I did not download the .sha1 files.

Help would be much appreciated in resolving this issue.

Please fix logging problem.

I cannot see the latest log until I input a command and execute it.

Download error | apk 1.2

on click the option "DOWNLOAD AND INSTALL SERVER.ZIP" and "TOGGLE AUTHENTICATION"

Stopping server doesn't always update button

Investigate why stopping the server sometimes leaves the button in the red kill state, even though the server shut down successfully.

Installing files from downloads not working

Selecting a server zip from the downloads view is currently broken, probably due to changes in newer Android versions.

The installation of 1.3 relase is impossible

I think the fault is the apk signature.

Cuberite won't install on LGK20+

For some reason it wont install, even though it installed on my other phone...

It says i "need an internet connection" even though i am on github on the phone iwas trying to install cuberite on.

Tag a new release

Start on boot

This is a wonderful application that makes possible to run a Minecraft server on a phone, this would be impossible with the official Minecraft server! However due to the very nature of Android it would be useful to have a "Start server on boot" option inside the settings, because otherwise it's not so easy to do without the tools of a traditional server/desktop OS. For a short term workaround, is there maybe a way I can start Cuberite and the server using the command line?
Thanks for your help and have a nice weekend.