{"id":13469831,"url":"https://gitlab.com/crafty-controller/crafty-4","last_synced_at":"2025-03-26T09:31:21.810Z","repository":{"id":50075416,"uuid":"20430749","full_name":"crafty-controller/crafty-4","owner":"crafty-controller","description":"Crafty 4 is the next iteration of our Minecraft Server Wrapper / Controller / Launcher. Boasting a clean new look, rebuilt from the ground up. Crafty 4 brings a whole host of new features such as Bedrock support. With SteamCMD support on the way!","archived":false,"fork":false,"pushed_at":null,"size":null,"stargazers_count":117,"open_issues_count":103,"forks_count":63,"subscribers_count":null,"default_branch":"master","last_synced_at":"2024-10-30T00:52:28.358Z","etag":null,"topics":["management","minecraft","python","server"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0+","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://gitlab.com/uploads/-/system/project/avatar/20430749/Crafty_4-0_Logo_square.ico","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-09T14:16:07.946Z","updated_at":"2024-10-22T15:39:44.278Z","dependencies_parsed_at":"2022-08-20T13:10:58.454Z","dependency_job_id":null,"html_url":"https://gitlab.com/crafty-controller/crafty-4","commit_stats":null,"previous_names":[],"tags_count":28,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/crafty-controller%2Fcrafty-4","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/crafty-controller%2Fcrafty-4/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/crafty-controller%2Fcrafty-4/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/crafty-controller%2Fcrafty-4/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/owners/crafty-controller","download_url":"https://gitlab.com/crafty-controller/crafty-4/-/archive/master/crafty-4-master.zip","host":{"name":"gitlab.com","url":"https://gitlab.com","kind":"gitlab","repositories_count":4518283,"owners_count":6894,"icon_url":"https://github.com/gitlab.png","version":null,"created_at":"2022-05-30T11:31:42.605Z","updated_at":"2024-07-18T11:24:13.055Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/owners"}},"keywords":["management","minecraft","python","server"],"created_at":"2024-07-31T16:00:17.286Z","updated_at":"2025-03-26T09:31:21.791Z","avatar_url":"https://gitlab.com/uploads/-/system/project/avatar/20430749/Crafty_4-0_Logo_square.ico","language":null,"funding_links":[],"categories":["Apps"],"sub_categories":["Gaming"],"readme":"[![Crafty Logo](app/frontend/static/assets/images/logo_long.svg)](https://craftycontrol.com)\n# Crafty Controller 4.4.7\n\u003e Python based Control Panel for your Minecraft Server\n\n## What is Crafty Controller?\nCrafty Controller is a Minecraft Server Control Panel / Launcher. The purpose\nof Crafty Controller is to launch a Minecraft Server in the background and present\na web interface for the server administrators to interact with their servers. Crafty\nis compatible with Docker, Linux, Windows 7, Windows 8 and Windows 10.\n\n## Documentation\nDocumentation available on [Crafty Docs](https://docs.craftycontrol.com)\n\n## Meta\nProject Homepage - https://craftycontrol.com\n\nDiscord Server - https://discord.gg/9VJPhCE\n\nGit Repository - https://gitlab.com/crafty-controller/crafty-4\n\nDocker Hub - [arcadiatechnology/crafty-4](https://hub.docker.com/r/arcadiatechnology/crafty-4)\n\n\u003cbr\u003e\n\n## Basic Docker Usage 🐳\n\nWith `Crafty Controller 4.0` we have focused on building our DevOps Principles, implementing build automation, and securing our containers, with the hopes of making our Container user's lives abit easier.\n\n### - Two big changes you will notice is:\n- We now provide pre-built images for you guys.\n- Containers now run as non-root, using practices used by OpenShift \u0026 Kubernetes (root group perms).\n\n\n\u003e __**⚠ 🔻WARNING: [WSL/WSL2 | WINDOWS 11 | DOCKER DESKTOP]🔻**__ \u003cbr\u003e\n BE ADVISED! Upstream is currently broken for Minecraft running on **Docker under WSL/WSL2, Windows 11 / DOCKER DESKTOP!** \u003cbr\u003e\n On '**Stop**' or '**Restart**' of the MC Server, there is a 90% chance the World's Chunks will be shredded irreparably! \u003cbr\u003e\n Please only run Docker on Linux, If you are using Windows we have a portable installs found here: [Latest-Stable](https://gitlab.com/crafty-controller/crafty-4/-/releases), [Latest-Development](https://gitlab.com/crafty-controller/crafty-4/-/jobs/artifacts/dev/download?job=win-dev-build)\n\n----\n\n### - To get started with docker 🛫\nAll you need to do is pull the image from this git repository's registry.\nThis is done by using `'docker-compose'` or `'docker run'` (You don't need to clone the Repository and build, like in 3.x ).\n\nIf you have a config folder already from previous local installation or _docker setup_*, the image should mount this volume and fix the permission as required, if no config present then it will populate its own config folder for you. \u003cbr\u003e \u003cbr\u003e\nAs the Dockerfile uses the permission structure of `crafty:root` **internally** there is no need to worry about matching the `UID` or `GID` on the host system :)\n\n\u003cbr\u003e\n\n### - Using the registry image 🌎\nThe provided image supports both `arm64` and `amd64` out the box, if you have issues though you can build it yourself with the `compose` file in `docker/`.\n\nThe image is located at: `registry.gitlab.com/crafty-controller/crafty-4:latest` or `arcadiatechnology/crafty-4`\n| Branch             | Status                                                                |\n| ----------------- | ------------------------------------------------------------------ |\n| :latest | [![pipeline status](https://gitlab.com/crafty-controller/crafty-4/badges/master/pipeline.svg)](https://gitlab.com/crafty-controller/crafty-4/-/commits/master) |\n| :dev | [![pipeline status](https://gitlab.com/crafty-controller/crafty-4/badges/dev/pipeline.svg)](https://gitlab.com/crafty-controller/crafty-4/-/commits/dev)\n\n\u003cbr\u003e\n\n**Here are some example methods for getting started🚀:**\n\n### **docker-compose.yml:**\n```sh\n# Make your compose file\n$ vim docker-compose.yml\n```\n```yml\nversion: '3'\n\nservices:\n  crafty:\n    container_name: crafty_container\n    image: registry.gitlab.com/crafty-controller/crafty-4:latest\n    restart: always\n    environment:\n      - TZ=Etc/UTC\n    ports:\n      - \"8000:8000\" # HTTP\n      - \"8443:8443\" # HTTPS\n      - \"8123:8123\" # DYNMAP\n      - \"19132:19132/udp\" # BEDROCK\n      - \"25500-25600:25500-25600\" # MC SERV PORT RANGE\n    volumes:\n      - ./docker/backups:/crafty/backups\n      - ./docker/logs:/crafty/logs\n      - ./docker/servers:/crafty/servers\n      - ./docker/config:/crafty/app/config\n      - ./docker/import:/crafty/import\n```\n```sh\n$ docker-compose up -d \u0026\u0026 docker-compose logs -f\n```\n\u003cbr\u003e\n\n### **docker run:**\n```sh\n$ docker run \\\n\t--name crafty_container \\\n\t--detach \\\n\t--restart always \\\n\t-p 8000:8000 \\\n\t-p 8443:8443 \\\n\t-p 8123:8123 \\\n\t-p 19132:19132/udp \\\n\t-p 25500-25600:25500-25600 \\\n\t-e TZ=Etc/UTC \\\n\t-v \"/$(pwd)/docker/backups:/crafty/backups\" \\\n\t-v \"/$(pwd)/docker/logs:/crafty/logs\" \\\n\t-v \"/$(pwd)/docker/servers:/crafty/servers\" \\\n\t-v \"/$(pwd)/docker/config:/crafty/app/config\" \\\n\t-v \"/$(pwd)/docker/import:/crafty/import\" \\\n\tregistry.gitlab.com/crafty-controller/crafty-4:latest\n```\n\n### **Building from the cloned repository:**\n\nIf you are building from `docker-compose` you can find the compose file in `./docker/docker-compose.yml` just `cd` to the docker directory and `docker-compose up -d`\n\nIf you'd rather not use `docker-compose` you can use the following `docker run` in the directory where the *Dockerfile* is:\n```sh\n# REMEMBER, Build your image first!\n$ docker build . -t crafty\n\n$ docker run \\\n\t--name crafty_container \\\n\t--detach \\\n\t--restart always \\\n\t-p 8000:8000 \\\n\t-p 8443:8443 \\\n\t-p 8123:8123 \\\n\t-p 19132:19132/udp \\\n\t-p 25500-25600:25500-25600 \\\n\t-e TZ=Etc/UTC \\\n\t-v \"/$(pwd)/docker/backups:/crafty/backups\" \\\n\t-v \"/$(pwd)/docker/logs:/crafty/logs\" \\\n\t-v \"/$(pwd)/docker/servers:/crafty/servers\" \\\n\t-v \"/$(pwd)/docker/config:/crafty/app/config\" \\\n\t-v \"/$(pwd)/docker/import:/crafty/import\" \\\n\tcrafty\n```\nA fresh build will take several minutes depending on your system, but will be rapid thereafter.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/gitlab.com%2Fcrafty-controller%2Fcrafty-4","html_url":"https://awesome.ecosyste.ms/projects/gitlab.com%2Fcrafty-controller%2Fcrafty-4","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/gitlab.com%2Fcrafty-controller%2Fcrafty-4/lists"}