{"id":13621681,"url":"https://github.com/dirien/minectl","last_synced_at":"2025-12-24T21:38:19.358Z","repository":{"id":36999777,"uuid":"382409059","full_name":"dirien/minectl","owner":"dirien","description":"minectl 🗺  is a cli for creating Minecraft server on different cloud provider.","archived":false,"fork":false,"pushed_at":"2025-03-24T19:35:42.000Z","size":23177,"stargazers_count":172,"open_issues_count":19,"forks_count":9,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-03-27T07:46:04.030Z","etag":null,"topics":["azure","civo","digitalocean","equinix","fabricmc","gce","golang","hacktoberfest","hetzner","hetzner-cloud","minecraft","oracle-cloud-infrastructure","ovh","ovhcloud","scaleway","spigotmc","vultr"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dirien.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-02T16:52:02.000Z","updated_at":"2025-02-26T22:09:38.000Z","dependencies_parsed_at":"2023-11-22T12:24:07.795Z","dependency_job_id":"7bff460e-4943-48a5-babd-deb20d53f7c1","html_url":"https://github.com/dirien/minectl","commit_stats":{"total_commits":640,"total_committers":11,"mean_commits":58.18181818181818,"dds":"0.42656249999999996","last_synced_commit":"e9558a46a27f8ab819e7d9ffd78ed256343d3a2c"},"previous_names":[],"tags_count":44,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fminectl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fminectl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fminectl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dirien%2Fminectl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dirien","download_url":"https://codeload.github.com/dirien/minectl/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247190250,"owners_count":20898702,"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":["azure","civo","digitalocean","equinix","fabricmc","gce","golang","hacktoberfest","hetzner","hetzner-cloud","minecraft","oracle-cloud-infrastructure","ovh","ovhcloud","scaleway","spigotmc","vultr"],"created_at":"2024-08-01T21:01:09.491Z","updated_at":"2025-12-24T21:38:19.350Z","avatar_url":"https://github.com/dirien.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"## New - 1.21.11 support\n\n`minectl 🗺`️️ supports the `Minecraft 1.21.11` version\n\n\u003cimg alt=\"logo\" src=\"docs/img/1_21_11_logo.png\" width=\"40%\"/\u003e\n\n# `minectl 🗺`\n\n![minectl](https://dirien.github.io/minectl/img/minectl.png)\n\n![Minecraft](https://img.shields.io/badge/Minecraft-62B47A?style=for-the-badge\u0026logo=Minecraft\u0026logoColor=white)\n![Go](https://img.shields.io/badge/go-00ADD8?style=for-the-badge\u0026logo=go\u0026logoColor=white)\n![Ubuntu](https://img.shields.io/badge/ubuntu_22.04-E95420?style=for-the-badge\u0026logo=ubuntu\u0026logoColor=white)\n![Prometheus](https://img.shields.io/badge/Prometheus-E6522C?style=for-the-badge\u0026logo=Prometheus\u0026logoColor=white)\n![Scaleway](https://img.shields.io/badge/scaleway-4F0599?style=for-the-badge\u0026logo=scaleway\u0026logoColor=white)\n![DigitalOcean](https://img.shields.io/badge/DigitalOcean-0080FF?style=for-the-badge\u0026logo=DigitalOcean\u0026logoColor=white)\n![Civo](https://img.shields.io/badge/Civo-239DFF?style=for-the-badge\u0026logo=Civo\u0026logoColor=white)\n![Akamai Connected Cloud](https://img.shields.io/badge/akamai_connected_cloud-0096D6?style=for-the-badge\u0026logo=akamai\u0026logoColor=white)\n![Hetzner](https://img.shields.io/badge/hetzner-d50c2d?style=for-the-badge\u0026logo=hetzner\u0026logoColor=white)\n![OVH](https://img.shields.io/badge/ovh-123F6D?style=for-the-badge\u0026logo=ovh\u0026logoColor=white)\n![Google Cloud](https://img.shields.io/badge/google_cloud-4285F4?style=for-the-badge\u0026logo=google-cloud\u0026logoColor=white)\n![Vultr](https://img.shields.io/badge/vultr-007BFC?style=for-the-badge\u0026logo=vultr\u0026logoColor=white)\n![Microsoft Azure](https://img.shields.io/badge/Microsoft_Azure-0078D4?style=for-the-badge\u0026logo=microsoft-azure\u0026logoColor=white)\n![Oracle Cloud Infrastructure](https://img.shields.io/badge/Oracle_Cloud_Infrastructure-F80000?style=for-the-badge\u0026logo=oracle\u0026logoColor=white)\n![Amazon AWS](https://img.shields.io/badge/Amazon_AWS-FF9900?style=for-the-badge\u0026logo=amazonaws\u0026logoColor=white)\n![VEXXHOST](https://img.shields.io/badge/VEXXHOST-2A1659?style=for-the-badge\u0026logo=vexxhost\u0026logoColor=white)\n![Multipass](https://img.shields.io/badge/Multipass-E95420?style=for-the-badge\u0026logo=ubuntu\u0026logoColor=white)\n![Exoscale](https://img.shields.io/badge/Exoscale-DA291C?style=for-the-badge\u0026logo=exoscale\u0026logoColor=white)\n![Fuga Cloud](https://img.shields.io/badge/fuga_cloud-242F4B?style=for-the-badge\u0026logo=fugacloud\u0026logoColor=white)\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/dirien/minectl.svg)](https://pkg.go.dev/github.com/dirien/minectl)\n[![Go Report Card](https://goreportcard.com/badge/github.com/dirien/minectl)](https://goreportcard.com/report/github.com/dirien/minectl)\n\n![GitHub Workflow Status (main)](https://img.shields.io/github/actions/workflow/status/dirien/minectl/ci.yaml?branch=main\u0026logo=github\u0026style=for-the-badge)\n![GitHub](https://img.shields.io/github/license/dirien/minectl?style=for-the-badge)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=dirien_minectl\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=dirien_minectl)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/dirien/minectl/badge?style=for-the-badge)](https://api.securityscorecards.dev/projects/github.com/dirien/minectl)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/5238/badge)](https://bestpractices.coreinfrastructure.org/projects/5238)\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/dirien/minectl?style=for-the-badge)\n\n[![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/minectl\u0026style=for-the-badge)](https://artifacthub.io/packages/search?repo=minectl)\n\n`minectl 🗺`️️ is a CLI for creating Minecraft servers on different cloud providers.\n\nIt is a private side project of me, to learn more about Go, CLI and multi-cloud environments.\n\n## Table of Contents\n\n- [Supported Cloud Providers](#supported-cloud-providers)\n- [Quick Start](#quick-start)\n- [Documentation](#documentation)\n- [Getting Started Guides](#getting-started-guides)\n- [Known Limitations](#known-limitations)\n- [Contributing](#contributing)\n- [Roadmap](#roadmap)\n- [Libraries \u0026 Tools](#libraries--tools)\n- [Legal Disclaimer](#legal-disclaimer)\n\n## Supported Cloud Providers\n\n| Provider | Website |\n|----------|---------|\n| Civo | https://www.civo.com/ |\n| Scaleway | https://www.scaleway.com |\n| DigitalOcean | https://www.digitalocean.com/ |\n| Hetzner | https://www.hetzner.com/ |\n| Akamai Connected Cloud | https://www.linode.com/ |\n| OVHCloud | https://www.ovh.com/ |\n| Google Compute Engine (GCE) | https://cloud.google.com/compute |\n| Azure | https://azure.microsoft.com/en-us/ |\n| Oracle Cloud Infrastructure | https://www.oracle.com/cloud/ |\n| Amazon AWS | https://aws.amazon.com/ |\n| VEXXHOST | https://vexxhost.com/ |\n| Multipass | https://multipass.run/ |\n| Exoscale | https://www.exoscale.com/ |\n| Fuga Cloud | https://fuga.cloud/ |\n\n## Quick Start\n\n### Installation\n\n#### Linux/macOS (Installation Script)\n\n```bash\ncurl -sLS https://get.minectl.dev | sudo sh\n```\n\nor without `sudo`:\n\n```bash\ncurl -sLS https://get.minectl.dev | sh\n```\n\n#### macOS (Homebrew)\n\n```bash\nbrew tap dirien/homebrew-dirien\nbrew install minectl\n```\n\n#### Windows (PowerShell)\n\n```powershell\n# Create directory\nNew-Item -Path \"$HOME/minectl/cli\" -Type Directory\n# Download file\nStart-BitsTransfer -Source https://github.com/dirien/minectl/releases/download/v0.7.0/minectl_0.7.0_windows_amd64.zip -Destination \"$HOME/minectl/cli/.\"\n# Uncompress zip file\nExpand-Archive $HOME/minectl/cli/*.zip -DestinationPath $HOME/minectl/cli/.\n# Add to Windows Environment Variables\n[Environment]::SetEnvironmentVariable(\"Path\",$($env:Path + \";$Home\\minectl\\cli\"),'User')\n```\n\n#### From Source\n\n```bash\ngit clone https://github.com/dirien/minectl\ncd minectl\nmake build\n```\n\n### Create Your First Server\n\n1. **Set up authentication** for your cloud provider ([see docs](docs/authentication.md))\n\n2. **Create a config file** using the wizard:\n   ```bash\n   minectl wizard\n   ```\n\n3. **Create the server**:\n   ```bash\n   minectl create --filename server.yaml\n   ```\n\n4. **Connect and play!**\n\n[![asciicast](https://asciinema.org/a/439572.svg)](https://asciinema.org/a/439572)\n\n## Documentation\n\n| Document | Description |\n|----------|-------------|\n| [Architecture](docs/architecture.md) | High-level architectural overview |\n| [Authentication](docs/authentication.md) | Cloud provider credentials setup |\n| [Configuration](docs/configuration.md) | Server and proxy configuration reference |\n| [CLI Reference](docs/cli-reference.md) | All commands and flags |\n| [Editions](docs/editions.md) | Supported Minecraft server and proxy editions |\n| [Features](docs/features.md) | Monitoring, volumes, security, and more |\n\n## Getting Started Guides\n\n- [Civo Java Edition](docs/getting-started-civo.md)\n- [Civo Bedrock Edition](docs/getting-started-civo-bedrock.md)\n- [Scaleway Java Edition](docs/getting-started-scaleway.md)\n- [GCE Edition](docs/getting-started-gce.md)\n- [Exoscale Edition](docs/getting-started-exoscale.md)\n- [Multi-cloud server monitoring](docs/multi-server-monitoring-civo.md)\n- [LuckyBlocks on Scaleway](docs/running-minecraft-luckyblocks-budget-scaleway.md)\n- [PaperMC SkyBlock on Hetzner](docs/skyblock-papermc-hetzner.md)\n\n## Known Limitations\n\n`minectl 🗺` is still under development. There will be the possibility for breaking changes.\n\n## Contributing\n\nFeel free to join! See our [contribution guidelines](CONTRIBUTING.md).\n\n**License:** Apache License, Version 2.0\n\n## Roadmap\n\n- [x] Support Bedrock edition [#10](https://github.com/dirien/minectl/issues/10)\n- [x] Add monitoring capabilities [#21](https://github.com/dirien/minectl/issues/21)\n- [x] List Minecraft Server [#11](https://github.com/dirien/minectl/issues/11)\n- [x] Update Minecraft Server [#12](https://github.com/dirien/minectl/issues/12)\n- [x] Hetzner support [#26](https://github.com/dirien/minectl/issues/26)\n- [x] Linode support [#31](https://github.com/dirien/minectl/issues/31)\n- [x] OVHCloud support [#43](https://github.com/dirien/minectl/issues/43)\n- [x] GCE support [#55](https://github.com/dirien/minectl/issues/55)\n- [x] Modded editions [#20](https://github.com/dirien/minectl/issues/20)\n- [x] Vultr support [#90](https://github.com/dirien/minectl/issues/90)\n- [x] Proxy servers (BungeeCord/Waterfall) [#95](https://github.com/dirien/minectl/issues/95)\n- [x] Azure support [#56](https://github.com/dirien/minectl/issues/56)\n- [x] Oracle/OCI support [#107](https://github.com/dirien/minectl/issues/107)\n- [x] AWS support [#210](https://github.com/dirien/minectl/pull/210)\n- [ ] Much more to come...\n\n## Libraries \u0026 Tools\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n- https://github.com/fatih/color\n- https://github.com/melbahja/goph\n- https://github.com/spf13/cobra\n- https://github.com/goreleaser\n- https://github.com/civo/civogo\n- https://github.com/digitalocean/godo\n- https://github.com/scaleway/scaleway-sdk-go\n- https://github.com/linode/linodego\n- https://github.com/hetznercloud/hcloud-go\n- https://github.com/olekukonko/tablewriter\n- https://github.com/sethvargo/go-password\n- https://github.com/ovh/go-ovh\n- https://github.com/dirien/ovh-go-sdk\n- https://github.com/hashicorp/go-retryablehttp\n- https://github.com/googleapis/google-api-go-client\n- https://github.com/Masterminds/sprig\n- https://github.com/Tnze/go-mc\n- https://github.com/c-bata/go-prompt\n- https://github.com/vultr/govultr\n- https://github.com/Azure/azure-sdk-for-go\n- https://github.com/blang/semver\n- https://github.com/tcnksm/go-latest\n- https://github.com/uber-go/zap\n- https://github.com/oracle/oci-go-sdk\n- https://github.com/AlecAivazis/survey\n- https://github.com/aws/aws-sdk-go\n- https://github.com/gophercloud/gophercloud\n- https://github.com/exoscale/egoscale\n\n\u003c/details\u003e\n\n## Legal Disclaimer\n\nThis project is not affiliated with Mojang Studios, XBox Game Studios, Double Eleven or the Minecraft brand.\n\n\"Minecraft\" is a trademark of Mojang Synergies AB.\n\nOther trademarks referenced herein are property of their respective owners.\n\n## Stargazers over time\n\n[![Stargazers over time](https://starchart.cc/dirien/minectl.svg)](https://starchart.cc/dirien/minectl)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirien%2Fminectl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdirien%2Fminectl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdirien%2Fminectl/lists"}