![\"AutoStopper](\"https:\/\/cdn.modrinth.com\/data\/PG4gqnzX\/images\/b2003a220072c1bfbb6255af452a39dab08a5377.png\")
\n<\/p>\n\n \n<\/p>\n
# AutoStopper<\/p>\n
AutoStopper is a Velocity proxy plugin that automatically stops and starts Minecraft server containers based on player activity. It helps server administrators save resources by shutting down inactive Docker-based Minecraft servers.<\/p>\n
## Download links<\/p>\n
– Modrinth<\/p>\n
## Features<\/p>\n
– Automatically monitors server activity
\n– Stops inactive Docker containers after a configurable timeout
\n– Starts servers on-demand when players try to connect
\n– Seamlessly connects players to servers after starting them
\n– Maintains server state tracking<\/p>\n
## Requirements<\/p>\n
– Velocity proxy server (3.3.0 or newer)
\n– Docker environment with itzg\/minecraft-server containers
\n– Docker socket mounted to the Velocity container
\n– Java 21+<\/p>\n
## Installation<\/p>\n
1. Download the latest AutoStopper JAR from the releases page
\n2. Place the JAR in your Velocity server’s `plugins` directory
\n3. Start (or restart) your Velocity server
\n4. Edit the generated configuration file to match your setup<\/p>\n
## Configuration<\/p>\n
After the first run, AutoStopper will generate a `config.yml` in the `plugins\/AutoStopper` directory:<\/p>\n
“`yaml
\n# Time in seconds before an inactive server is stopped
\ninactivity_timeout_seconds: 900<\/p>\n
# List of servers AutoStopper should manage
\nmonitored_servers:
\n – server_name: purpur
\n container_name: purpur-server
\n – server_name: fabric
\n container_name: fabric-server
\n“`<\/p>\n
### Configuration Options<\/p>\n
– `inactivity_timeout_seconds`: Time in seconds a server must be inactive before being shut down (default: 900 seconds\/15 minutes)
\n– `monitored_servers`: List of server mappings
\n – `server_name`: Name of the server in Velocity configuration
\n – `container_name`: Corresponding Docker container name<\/p>\n
## Docker Setup<\/p>\n
AutoStopper requires the Docker socket to be mounted in your Velocity container. Here’s an example `docker-compose.yml` setup:<\/p>\n
“`yaml
\nservices:
\n velocity:
\n image: itzg\/mc-proxy
\n container_name: velocity-server
\n environment:
\n TYPE: “VELOCITY”
\n ONLINE_MODE: “true”
\n VELOCITY_VERSION: “latest”
\n VELOCITY_BUILD_ID: “latest”
\n REPLACE_ENV_VARIABLES: “true”
\n ports:
\n – “25565:25565”
\n volumes:
\n – .\/velocity_server:\/server
\n – \/var\/run\/docker.sock:\/var\/run\/docker.sock # Required for AutoStopper
\n networks:
\n – mc-network
\n restart: unless-stopped
\n entrypoint: bash -c
\n command: >
\n “if [ ! -f \/usr\/bin\/docker ]; then
\n apt-get update && apt-get install -y docker.io && apt-get clean;
\n fi &&
\n SOCKET_GID=$$(stat -c ‘%g’ \/var\/run\/docker.sock) &&
\n if ! getent group $$SOCKET_GID > \/dev\/null; then groupadd -g $$SOCKET_GID docker_sock; fi &&
\n GROUP_NAME=$$(getent group $$SOCKET_GID | cut -d: -f1) &&
\n usermod -aG $$GROUP_NAME bungeecord &&
\n exec \/usr\/bin\/run-bungeecord.sh”<\/p>\n
# Example Minecraft servers that can be managed by AutoStopper
\n purpur:
\n image: itzg\/minecraft-server:java21
\n container_name: purpur-server
\n environment:
\n TYPE: “PURPUR”
\n VERSION: “1.21.4”
\n EULA: “TRUE”
\n ONLINE_MODE: “FALSE”
\n volumes:
\n – .\/purpur_data:\/data
\n networks:
\n – mc-network
\n restart: “no” # Important: Let AutoStopper manage the container lifecycle<\/p>\n
fabric:
\n image: itzg\/minecraft-server:java21
\n container_name: fabric-server
\n environment:
\n TYPE: “FABRIC”
\n VERSION: “1.21.4”
\n EULA: “TRUE”
\n ONLINE_MODE: “FALSE”
\n volumes:
\n – .\/fabric_data:\/data
\n networks:
\n – mc-network
\n restart: “no” # Important: Let AutoStopper manage the container lifecycle<\/p>\n
networks:
\n mc-network:
\n driver: bridge
\n“`<\/p>\n
### Important Docker Configuration Notes<\/p>\n
1. The Velocity container must have Docker CLI installed, which is why the entrypoint script installs it
\n2. The Docker socket must be mounted (`\/var\/run\/docker.sock:\/var\/run\/docker.sock`)
\n3. The script automatically handles permissions by detecting the socket group ID and adding the server user to it.
\n4. Set `restart: “no”` for managed servers so Docker doesn’t automatically restart them
\n5. Keep any hub\/lobby servers with `restart: unless-stopped` if you want them to always be available<\/p>\n
## Commands<\/p>\n
– `\/autostopper` or `\/as` – Main command
\n– `\/autostopper help` – Displays help information
\n– `\/autostopper status` – Shows the status of all monitored servers
\n– `\/autostopper reload` – Reloads the configuration (requires `autostopper.admin` permission)<\/p>\n
## Permissions<\/p>\n
– `autostopper.admin` – Allows use of the reload command<\/p>\n
## How It Works<\/p>\n
1. When a player attempts to connect to a monitored server:
\n – If the server is running, the connection proceeds normally
\n – If the server is stopped, AutoStopper:
\n – Starts the Docker container
\n – Waits for the server to fully initialize
\n – Automatically connects the player once the server is ready<\/p>\n
2. The plugin tracks the last activity time for each server
\n3. A scheduled task checks for inactive servers and stops them after the configured timeout period
\n4. Servers that are always needed (like hubs\/lobbies) can be excluded from monitoring<\/p>\n
## Building from Source<\/p>\n
1. Clone the repository
\n2. Build using Maven:<\/p>\n
“`bash
\n mvn clean package
\n “`<\/p>\n
3. Find the JAR file in `target\/AutoStopper-1.1.2.jar`<\/p>\n
## License<\/p>\n
This project is licensed under the [MIT License](LICENSE). See the LICENSE file for details.<\/p>\n
## Credits<\/p>\n
– Built for Velocity by Criseda
\n– Uses itzg\/minecraft-server
\n– Uses itzg\/mc-proxy<\/p>\n","protected":false},"excerpt":{"rendered":"
A Velocity proxy plugin that automatically stops and starts Minecraft server containers based on player activity<\/p>\n","protected":false},"featured_media":23785,"template":"","meta":{"_minecraft_slug":"autostopper","_minecraft_project_id":"PG4gqnzX","_minecraft_author":"Criseda","_minecraft_license":"MIT","_minecraft_downloads":52,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"autostopper.zip","_minecraft_size_bytes":643083,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:02:08.509454Z","_minecraft_date_created":"2025-04-20T18:22:45.696782Z","_minecraft_date_modified":"2026-01-14T16:59:08.773826Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/autostopper","_minecraft_icon_attachment_id":23785,"_minecraft_imported_at":"2026-06-01T08:01:51+00:00","_minecraft_import_hash":"7f1bc156e86526a04579b283d74f0063","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,91,92,985],"mod_loader":[986],"minecraft_version":[60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-23905","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-storage","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n