Forge Home


Minecraft Server


10,818 latest version

3.9 quality score

Version information

  • 1.0.0 (latest)
  • 0.1.4
  • 0.1.3
  • 0.1.2
  • 0.1.1
released Nov 29th 2012

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'branan-minecraft', '1.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add branan-minecraft
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install branan-minecraft --version 1.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Tags: minecraft


branan/minecraft — version 1.0.0 Nov 29th 2012

Puppet Module for Minecraft

puppet-minecraft installs and configures your Minecraft server with Puppet!


The simplest possible usage is

class { 'minecraft': }

Parameters are available which control how the Minecraft installation behaves:

  • user: The user account for the Minecraft service
  • group: The user group for the Minecraft service
  • homedir: The directory in which Minecraft stores its data
  • manage_java: Should this module manage the java package?
  • manage_screen: Should this module manage the screen package?
  • manage_curl: Should this module manage the curl package?
  • heap_size: The maximum Java heap size for the Minecraft service in megabytes
  • heap_start: The initial Java heap size for the Minecraft service in megabytes`

Server configuration

Full configuration of the Minecraft server is supported. Simply use the minecraft::server_prop type.

minecraft::server_prop { 'spawn-monsters':
  value => 'true'

Consult your favorite Minecraft resource for the full list of server properties.

Managing players

This module includes several Puppet defines to allow managing the players on your server

  • minecraft::op { $player: }: Add $player to the auto-op list
  • minecraft::whitelist { $player: }: Add $player to the server whitelist
  • minecraft::ban { $player: }: Add $player to the server ban list
  • minecraft::ipban { $ipaddr: }: Add $ipaddr to the server ip-ban list