{"id":40853243,"url":"https://github.com/jseashell/ezmc-cli","last_synced_at":"2026-01-21T23:42:44.143Z","repository":{"id":65279432,"uuid":"588912035","full_name":"jseashell/ezmc-cli","owner":"jseashell","description":"A server management CLI for self-hosting a Minecraft Java server with AWS Elastic Container Service.","archived":false,"fork":false,"pushed_at":"2024-08-25T04:22:48.000Z","size":1346,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-08-25T05:22:33.924Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jseashell.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-14T13:04:35.000Z","updated_at":"2024-08-25T05:22:45.480Z","dependencies_parsed_at":"2024-08-25T05:22:02.966Z","dependency_job_id":"eae877df-d063-4f2a-a7d9-ad223170be2e","html_url":"https://github.com/jseashell/ezmc-cli","commit_stats":null,"previous_names":["jseashell/ezmc-admin-service","jseashell/ezmc-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jseashell/ezmc-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jseashell%2Fezmc-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jseashell%2Fezmc-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jseashell%2Fezmc-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jseashell%2Fezmc-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jseashell","download_url":"https://codeload.github.com/jseashell/ezmc-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jseashell%2Fezmc-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28646953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T21:29:11.980Z","status":"ssl_error","status_checked_at":"2026-01-21T21:24:31.872Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-01-21T23:42:43.530Z","updated_at":"2026-01-21T23:42:44.137Z","avatar_url":"https://github.com/jseashell.png","language":"TypeScript","funding_links":["https://www.buymeacoffee.com/jseashell"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\" style=\"background: url(docs/images/mc-dirt-banner.webp); padding: 2rem\"\u003e\n  \u003cimg src=\"./docs/images/logo-sm.png\" width=\"260\" alt=\"EZMC Logo\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://github.com/jseashell/ezmc-cli/actions/workflows/build.yml/badge.svg\" alt=\"Build badge\"/\u003e\n    \u003cimg src=\"https://sonarcloud.io/api/project_badges/measure?project=jseashell_ezmc-cli\u0026metric=coverage\" alt=\"Coverage badge\" /\u003e\n    \u003cimg src=\"https://sonarcloud.io/api/project_badges/measure?project=jseashell_ezmc-cli\u0026metric=reliability_rating\" alt=\"Reliability badge\" /\u003e\n    \u003cimg src=\"https://sonarcloud.io/api/project_badges/measure?project=jseashell_ezmc-cli\u0026metric=security_rating\" alt=\"Security badge\" /\u003e\n    \u003cimg src=\"https://sonarcloud.io/api/project_badges/measure?project=jseashell_ezmc-cli\u0026metric=vulnerabilities\" alt=\"Vulnerabilities badge\" /\u003e\n    \u003cimg src=\"https://sonarcloud.io/api/project_badges/measure?project=jseashell_ezmc-cli\u0026metric=bugs\" alt=\"Bugs badge\" /\u003e\n    \u003ca href=\"https://www.buymeacoffee.com/jseashell\" aria-label=\"Buy me a coffee\"\u003e\n      \u003cimg src=\"https://img.shields.io/badge/Donate-Buy%20me%20a%20coffee-orange.svg\" alt=\"Buy me a coffee badge\" /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\nA server management CLI for self-hosting Minecraft Java Edition with AWS Elastic Container Service. This project is a wrapper around the AWS SDK and [vatertime/minecraft-spot-pricing](https://github.com/vatertime/minecraft-spot-pricing), a CloudFormation template for managing resources that provisions the [itzg/docker-minecraft-server](https://github.com/itzg/docker-minecraft-server) Docker image.\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./public/terminal.png\" alt=\"Example\"/\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Commands](#commands)\n- [Parameters](#parameters)\n- [Infrastructure](#infrastructure)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- Useful [commands](#commands) for orchestrating containers with the AWS SDK\n- Supports vanilla and modded servers\n- [vatertime/minecraft-spot-pricing](https://github.com/vatertime/minecraft-spot-pricing) claims an inexpensive $10/mo for a server running full-time. However, it's recommended to `stop` the server when not in use to save money. Spot pricing is set to 5¢.\n\n## Prerequisites\n\n- [Sign up](https://aws.amazon.com/free) for AWS. Be sure to setup billing.\n- [Setup the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)\n- Node.js v20+, `.nvmrc` is included\n\n## Commands\n\n| Command  | Description                                                                  |\n| :------- | :--------------------------------------------------------------------------- |\n| `cip`    | Copies a server's ip address to the clipboard.                               |\n| `ip`     | Displays a server's ip address.                                              |\n| `ls`     | Lists your servers.                                                          |\n| `new`    | Creates a new server. Wait 5 minutes for commands like `ipaddr` or `status`. |\n| `params` | Get/set server parameters.                                                   |\n| `rm`     | Removes a server (cannot be undone).                                         |\n| `start`  | Starts a server.                                                             |\n| `status` | Displays a server's status.                                                  |\n| `stop`   | Stops a server.                                                              |\n| `help`   | Displays help.                                                               |\n\n## Parameters\n\n### Notable Defaults\n\n| Option        | Value    |\n| :------------ | :------- |\n| Max players   | 10       |\n| Difficulty    | Normal   |\n| View Distance | 10       |\n| Game Mode     | Survival |\n| Level Type    | Default  |\n\n## Infrastructure\n\nResources are provisioned using your default AWS CLI profile, falling back to `us-east-1` as a default region.\n\nAWS Elastic Container Service is used to deploy the Minecraft image. EC2 instance(s) are spun up upon request and remain running until told to shutdown via the `stop` command (remove the server entirely with `rm`).\n\n\u003e Contributors are not responsible for any AWS costs incurred from using this CLI. Use at your own discretion.\n\nEach \"server\" is given its own networking stack and ECS cluster for simple clean up -- keeps it ez. By default, your AWS account will be limited to 5 VPCs. With the default VPC, and assuming zero other provisioned resources, that means you can have a maximum of 4 servers operating simulateously.\n\n## Contributing\n\n### Pull Requests\n\nPull requests are welcomed. Please leave detailed reasoning for your change. Bugs should include reproduction steps. OS can sometimes be helpful but this project lets [commander.js](https://github.com/tj/commander.js) manage cross-platform compatibility.\n\n### Development\n\n```sh\ngit clone git@github.com:jseashell/ezmc-cli.git\nnpm install\nnpm run build\nchmod +x bin/*\nnode bin/index.js ls\n# optional, use like a normal global package\nnpm link\nezmc ls\n```\n\n## License\n\nThis project is distributed under the terms of the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjseashell%2Fezmc-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjseashell%2Fezmc-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjseashell%2Fezmc-cli/lists"}