MineColab_Improved
An alternative Minecolab project. --------- Original: https://github.com/thecoder-001/MineColab ----------------------- Wiki: https://minecolabimproved-wiki-gg.translate.goog/es/wiki/MineColab_Improved_Wiki?_x_tr_sl=es&_x_tr_tl=en&_x_tr_hl=es&_x_tr_pto=wapp
Last updated Jun 30, 2026
265
Stars
81
Forks
1
Issues
0
Stars/day
Attention Score
88
Topics
Language breakdown
No language data available.
▸ Files
click to expand
README
[!CAUTION]
Google Colab has permanently auto-banned MineColab Improved projects from their system. Any user trying to use MCI will be automatically stopped from running environments, and if persistent it will banned.
Mine Colab [Improved]
Run Minecraft Server on Google Colab
:hearnoevil: First of all, what is Mine Colab [Improved]?
Mine Colab [Improved] is an alternative Minecolab project that helps to build a Minecraft server on your own Google Drive. It is easier to use and more flexible to edit. This project is suited mainly for Google Colab, a paid service of Google with free plans based on Jupyter Notebook and Ubuntu OS. Anyway, this notebook can be used on other projects like Jupyter Lab, Deepnote, etc... taking into account it may require some modifications depending on the service. This project follows the GNU License. Before looking closer to it, please make sure to take a look into the original project by thecoder-001
:moneybag: Can MCI run your server online 24/7?
Of course, it's possible but with a little hard work. Google Colab is a free service and it is not suited for 24/7, but 12 hours online so in the case you want your server to be accesible 24/7 you could use Deepnote instead.
[!WARNING]
Take into account that when using Deepnote some modifications to the internal code of the notebook might be required.
If you still want to use Google Colab take into account that your server uptime will depend on Google Colab's actual usage of their servers and you may need to use some tricks that we will not provide (sorry) or friends to make the web online and accept the captcha manually.
[!TIP]
We suggest to take into account that your server will elap around 10 hours. Being in that case sure that your server will not be forced stopped by Google Colab unless they require your resources for a paid or uncommon user.
:pagewithcurl: Instructions
- Open the notebook in Google Colab.
- Run the SET-UP CELL (important)
- Read through the notebook, most of the cells are self-explanatory with easy-reading and for-all markdown (information of what the cells do). Run the cells that are useful for your use case.
[!IMPORTANT]
Remember that you can take a look to our whole wiki in the case you need some information or just want to be updated of what does each section of the notebook.
Create your own Minecraft server
[!TIP]
Use a TPU runtime if possible and select the best Tunneling Service that fits with you to have the best performance.
- Run the cell that creates the Minecraft server. More info here.
- After that, select your prefered tunneling service, complete it's steps and connect to your server! Take a look to the wiki to know how to use each one or continue to the next section.
<your Cloudflare file name> access tcp --hostname <tunneladdress> --url 127.0.0.1:25565 (note: tunneladdress is your address which has been set on your Cloudflare).
4. Finally, connect to 127.0.0.1:25565 from the minecraft client which is located in that machine.
1. Navigate to TCP-UDG page. Select TCP in Protocol Types.
2. Get your authtoken from Authtoken.
3. Pick the server you'd like your tunnel to operate on.
4. Input the IP and Port values the tunnel will listen to, in this case, for Minecraft, it's typically IP: 127.0.0.1 and Port: 25565.
5. Finally, create and start your tunnel by pressing the Start button.
- Read more on how-to-use-localtonet-with-minecraft.
- Zrok:
zrok invite to sign up and get the authtoken. 3. Follow the prompts.
1. Follow the prompts.
1. Create or edit a server and select the Minekube service in the Change Tunnel Service section or during server creation.
2. Create an account on Minekube and generate an Endpoint.
3. Reboot, copy the Token and paste it into Change Tunnel Token (in the tunneling options, with minekube-gate enabled).
4. Turn the server on and then off to generate the necessary folders.
5. Open your file server.properties and disable the following parameters:
- enforce-secure-profile
- online-mode
6. Then, open the Minekube file config.yml (located in the tunnels folder).
7. Find the line that contains #name you-endpoint-name, remove the # and after the : write the name of your Endpoint.
8. Finally, turn on the server and let the notebook create a PlayIt connector for you automatically.
- Take into account that if you haven't registered PlayIt on the notebook before, you will be asked for.
[!CAUTION]
When writing your name you should just write the name before the first colon of the link (without the .play.minekube).
:zap: So, how does it actually work?
MInecolab [Improved] is an alternative Minecolab project. Therefore, it has all the main features which the Minecolab project does:- Update the system's apt-cache.
- Install Openjdk-8 (For Minecraft versions below 1.17) or Openjdk-17 (For Minecraft versions over or in 1.17) through apt-get.
- Mount Google Drive to access the Minecraft folder (Drive is used here to provide persistent storage).
- Setup Argo/ngrok/playit Tunnel (Opening a tunnel at port 25565) depending on the
tunnel_servicevariable. - Change the directory to the Minecraft server folder on Google Drive ("Minecraft-server" is the default, located in the root directory of your Google Drive.)
- List/Print the file list on the screen to indicate successful directory change.
- Startup the Minecraft server (with optimized JVM parameters from Aikar's guide) and from GC logging.
- Bug Fixes: Mine Colab [Improved] addresses issues like Java errors, connection disruptions, and missing files, ensuring a smoother experience.
- Performance Improvements: The project has been optimized for better performance, making it more efficient.
- Mod and Plugin Support: You can now easily integrate mods, plugins, and mod packs from two primary sources: Modrinth and CurseForge.
- Server Configuration:
- Server Icon Configuration: Choose an icon to represent your server visually.
- Logs Viewing: Access and review server logs to troubleshoot issues or monitor server activity.
- Server Backup: Create backups of your server data in zip files, ensuring data safety.
- Expanded Software Support:
- Continued developing to improve each version and mantain up to date!
🔮 License:
🐛 Found a bug?
- Report the bug by creating a new issue and use this helpful issue template.
- Suggest a new feature using this template.
- See all work that has been done, in processed, or what I want to do in the future from minecolab improve roadmap
👍 Notes
- Please use the FUNCTION in the notebook unless you want any ERRORS/BUGS.
- If something does not work, try using a VPN like windscribe before opening an issue.
- Switch between the three tunnel providers and see which works best.
- Make regular backups of your world.
- Google Colab is not designed to create Minecraft servers, but it can be done. Google Colab promises to work for 12 hours straight, however, it is possible that if no person is reviewing the page or using the console, basically if the page detects inactivity the process will end. The performance is approximately 12 GB of RAM, together with a processor with a power of 2.2 GHz and 2 threads, this is better than many paid hostings, but it doesn't have support and doesn't promise to be open always
- It is not advisable to fill it with as many as plugins, which is more limited to this server than its own processor, it is not very good, any hosting for 12 USD can offer a higher quality server, if you are thinking of creating something for many users, it's much better.
