https://github.com/joanroig/admincraft

Multiplatform app to control Minecraft Bedrock Dockerized servers, built with Flutter.
https://github.com/joanroig/admincraft

admincraft docker flutter minecraft minecraft-bedrock minecraft-docker minecraft-server minecraft-server-management

Last synced: about 2 months ago
JSON representation

Multiplatform app to control Minecraft Bedrock Dockerized servers, built with Flutter.

• Host: GitHub
• URL: https://github.com/joanroig/admincraft
• Owner: joanroig
• License: gpl-3.0
• Created: 2024-08-31T12:10:39.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2025-03-30T09:54:51.000Z (about 2 months ago)
• Last Synced: 2025-03-30T10:26:09.467Z (about 2 months ago)
• Topics: admincraft, docker, flutter, minecraft, minecraft-bedrock, minecraft-docker, minecraft-server, minecraft-server-management
• Language: Dart
• Homepage:
• Size: 1.72 MB
• Stars: 10
• Watchers: 1
• Forks: 2
• Open Issues: 29
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        


  

      

  





  Admincraft





  Multiplatform app to control Minecraft Bedrock Dockerized servers, built with Flutter.





  

    

  

  

    

  

  

    

  

  

    

  





  



## ![Admincraft logo](docs/logo/variants/dirt.png) What is Admincraft?

Admincraft is a multiplatform app for managing Minecraft Bedrock servers in Docker containers. Given that RCON isn't available for Bedrock, Admincraft uses the [Admincraft WebSocket](https://github.com/joanroig/admincraft-websocket) project to interact with the Minecraft server. This approach allows for secure and real-time command execution and server management through a WebSocket connection, providing an intuitive GUI for tasks such as issuing commands, performing server maintenance, and monitoring server logs.

### Current project status

- Currently optimized for use with Oracle Always Free, using a server created with [docker-minecraft-bedrock-server](https://github.com/itzg/docker-minecraft-bedrock-server/tree/master).

- Development is focused on Android and Windows; other platforms may be unstable.

## ![Admincraft logo](docs/logo/variants/pig.png) Getting Started

You need a Minecraft Bedrock server and [Admincraft WebSocket](https://github.com/joanroig/admincraft-websocket) running in Docker to use Admincraft. Visit the [server setup guide](docs/server/SERVER_SETUP.md) to set up yours for free!

Once you have your server ready, [download Admincraft for your platform](https://github.com/joanroig/admincraft/releases), add your server in the app, and you're good to go!

## ![Admincraft logo](docs/logo/variants/obsidian.png) Development

- Follow the official [Flutter installation guide](https://docs.flutter.dev/get-started/install).

- Open the project in the IDE of your choice ([VSCode](https://code.visualstudio.com/) is recommended) and run the app by following [this guide](https://docs.flutter.dev/tools/vs-code#running-and-debugging).

### Build Android APK

- Run `flutter build apk`.

- The APK will be available at [build/app/outputs/apk/release](build/app/outputs/apk/release).

### Build Windows Executable

- Run `flutter build windows`.

- The .exe file with the required files will be available at [build/windows/x64/runner/Release](build/windows/x64/runner/Release).

## ![Admincraft logo](docs/logo/variants/grass.png) Feature Roadmap

You can view the planned, started, and completed features in [GitHub Projects](https://github.com/users/joanroig/projects/2/views/2).

## ![Admincraft logo](docs/logo/variants/villager.png) Community & Contributions

The community and team are available in [GitHub Discussions](https://github.com/joanroig/admincraft/discussions), where you can ask for support, discuss the roadmap, and share ideas.

Our [Contribution Guide](https://github.com/joanroig/admincraft/blob/main/CONTRIBUTING.md) describes how to contribute to the codebase and documentation.

## ![Admincraft logo](docs/logo/variants/enderman.png) Credits

Docker tools

- [docker-minecraft-bedrock-server](https://github.com/itzg/docker-minecraft-bedrock-server)

- [Bedrockifier](https://github.com/Kaiede/Bedrockifier)

- [Admincraft WebSocket](https://github.com/joanroig/admincraft-websocket)

Fonts

- [Miracode](https://github.com/IdreesInc/Miracode)

- [Scientifica](https://github.com/oppiliappan/scientifica)

- [Monocraft](https://github.com/IdreesInc/Monocraft)

## ![Admincraft logo](docs/logo/variants/cow.png) License

Licensed under the [GPLv3 License](https://github.com/joanroig/admincraft/blob/main/LICENSE.txt).