Menu

Chef Supermarket

Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

View our collection of guides, documentation, and articles

Cookbooks
Advanced Options

Select Badges

Select Supported Platforms

Select Status

RSS

minecraft-server (3) Versions 0.1.2

Installs/Configures Vanilla, Spigot, Bungeecord, and Bukkit Minecraft servers

Policyfile
Berkshelf
Knife 
cookbook 'minecraft-server', '= 0.1.2', :supermarket
cookbook 'minecraft-server', '= 0.1.2'
knife supermarket install minecraft-server
knife supermarket download minecraft-server
README
Dependencies
Changelog
Quality 0%

minecraft-server cookbook

Table of Contents

  1. Description
  2. Requirements
  3. Usage
    1. Recipes
    2. Resources
    3. Example Usage

Description

A simple cookbook for installing and maintaining Minecraft servers.

It currently supports 3 different type of Minecraft servers:

Requirements

Chef

  • Chef 12.5+

Platforms

  • Centos 6+
  • Ubuntu 14+

Usage

In your Berksfile include this cookbook by putting cookbook 'minecraft-server', git: 'git://github.com/Mac-Genius/minecraft-server.git'. Then inside your metadata.rb file include depends 'minecraft-server'.

Recipes

There are no recipes! You can use the custom resources to create a server.

Resources

minecraft_depend

This provides all the dependencies for this cookbook, including Java, screen, unzip, and git.

Actions

  • :install: installs the dependencies

Attributes

  • name: the name of the resource
  • install_all: installs all dependencies needed to run a Minecraft server
  • install_git: installs git
  • install_java: installs java
  • install_screen: installs screen
  • install_unzip: installs unzip
  • java_flavor: what kind of java should be installed (oracle, openjdk, etc.)
  • java_version: the java version that should be installed

minecraft_server

This will setup the vanilla Minecraft server including the service files.

Actions

  • :create: installs the Minecraft server
  • :update: updates the Minecraft server's jar and world
  • :delete: uninstalls the Minecraft server

Attributes

  • name: the name of the server
  • eula: whether you agree to Minecraft terms of service. You need to agree to it during the :create action to ensure the server is created
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory
  • reset_world: whether to reset the world when using the :update action
  • snapshot: whether the server should be a snapshot
  • version: the version of minecraft to install. Defaults to the latest version
  • world: a url to a zipped world file

server_properties

This will update the server properties

Actions

  • :update: updates the Minecraft server's server.properties file

Attributes

  • name: the name of the server
  • settings: a hash of the server properties
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory

minecraft_service

This will create the necessary service files and run, restart, and stop the Minecraft server.

Actions

  • :start: start the Minecraft server
  • :stop: stop the Minecraft server
  • :restart: restart the Minecraft server
  • :enable: enables the Minecraft server to restart after a server reboot
  • :disable: disables automatic Minecraft startup
  • :create: creates the service files for the Minecraft server
  • :update: updates the service files for the Minecraft server
  • :delete: deletes the service files for the Minecraft server

Attributes

  • service_name: the name of the service for a Minecraft server
  • commands: a command or list of commands to be ran after a server startes or before a server stops
  • command_delay: the delay between the execution of Minecraft commands
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory
  • jar_name: the name of the jar excluding the '.jar' at the end
  • delay: the amount of time to wait for a server to start or stop

spigot_server

This will setup the Spigot Minecraft server including the service files.

Actions

  • :create: installs the Spigot Minecraft server
  • :update: updates the Spigot Minecraft server's jar and world
  • :delete: uninstalls the Spigot Minecraft server

Attributes

  • name: the name of the server
  • build_tools_dir: the directory to put BuildTools. Defaults to /opt/build_tools
  • eula: whether you agree to Minecraft terms of service. You need to agree to it during the :create action to ensure the server is created
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory
  • reset_world: whether to reset the world when using the :update action
  • version: the version of minecraft to install. Defaults to the latest version
  • world: a url to a zipped world file
  • update_jar: whether to check for a patch for the current version of Spigot

spigot_yml

This will setup the Spigot server's spigot.yml file.

Actions

  • :update: updates the Minecraft server's jar and world
  • :reset: resets the spigot.yml file back to its default form

Attributes

  • name: the name of the server
  • settings: the settings for the spigot.yml as a hash
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory

bukkit_server

This will setup the Bukkit Minecraft server including the service files.

Actions

  • :create: installs the Bukkit Minecraft server
  • :update: updates the Bukkit Minecraft server's jar and world
  • :delete: uninstalls the Bukkit Minecraft server

Attributes

  • name: the name of the server
  • build_tools_dir: the directory to put BuildTools. Defaults to /opt/build_tools
  • eula: whether you agree to Minecraft terms of service. You need to agree to it during the :create action to ensure the server is created
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory
  • reset_world: whether to reset the world when using the :update action
  • version: the version of minecraft to install. Defaults to the latest version
  • world: a url to a zipped world file
  • update_jar: whether to check for a patch for the current version of Bukkit

bukkit_yml

This will setup the Bukkit server's spigot.yml file.

Actions

  • :update: updates the Minecraft server's jar and world
  • :reset: resets the bukkit.yml file back to its default form

Attributes

  • name: the name of the server
  • settings: the settings for the bukkit.yml as a hash
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory

bukkit_plugin

This will install, update, and delete plugins.

Actions

  • :install: installs the Bukkit plugin
  • :update: updates the Bukkit plugin
  • :delete: removes the Bukkit plugin

Attributes

  • id: the name of the plugin from the url. ex) http://dev.bukkit.org/bukkit-plugins/<plugin-name-here>
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory
  • servers: a string or list of server names to install, update, or delete a plugin on
  • version: the version of the plugin to install. Defaults to the latest version
  • source: a url to the jar. Only needed if the plugin is not on Bukkit.org. spigotmc.org/resources links do not work because of Cloudflare!

build_tools

This will setup BuildTools for creating the Bukkit and Spigot jars. When using the spigot_server/bukkit_server resource, that resource will automatically build the jars. You do not need to use this.

Actions

  • :install: installs BuildTools
  • :reset: resets the bukkit.yml file back to its default form

Attributes

  • name: the name of the server
  • group: the group permission that owns the server files
  • owner: the owner permission that owns the server files
  • path: the path to the server directory
  • source: the link to BuildTools. defaults to the latest stable version
  • update_jar: whether the current version of Spigot or Bukkit should be updated
  • version: the version of Spigot or Bukkit to build

Example Usage

Creating a vanilla server

# installs all dependencies
minecraft_depend 'dependencies' do
  install_all true
end

# installs the server and service files
minecraft_server 'test' do
  eula true
  action :create
end

# set properties for the server
server_properties 'test' do
  settings({
    :motd => 'Welcome to a Chef example server!',
    :enable_command_block => true,
    :difficulty => 3
  })
end

# starts the server
minecraft_service 'test' do
  commands 'say Server is now online!'
  action :start
end

Updating a vanilla server

# updates the server version and resets the world
# this will automatically stop and restart your server
minecraft_server 'test' do
  reset_world true
  version '1.9.4'
  action :update
end

Update the properties of a vanilla server

# starts the server
minecraft_service 'test' do
  commands ['say The server is restarting!', 'say It will be back soon!']
  action :stop
end

# set properties for the server
server_properties 'test' do
  settings({
    :motd => 'Welcome to a Chef example server!',
    :enable_command_block => true,
    :difficulty => 3
  })
end

# starts the server
minecraft_service 'test' do
  commands 'say Server is now online!'
  action :start
end

Delete a vanilla server

# uninstalls the server and service files
minecraft_server 'test' do
  action :delete
end

Create a Spigot or Bukkit server

(replace spigot with bukkit to create a bukkit server)

# installs all dependencies
minecraft_depend 'dependencies' do
  install_all true
end

# installs the server and service files
spigot_server 'test' do
  eula true
  action :create
end

# set properties for the server
server_properties 'test' do
  settings({
    :motd => 'Welcome to a Chef example server!',
    :enable_command_block => true,
    :difficulty => 3
  })
end

# update the spigot.yml file
spigot_yml 'test' do
  settings({
    settings => {
      :debug => true
    }
  })
end

bukkit_plugin 'worldedit' do
  servers 'test'
  action :install
end

bukkit_plugin 'Essentials' do
  source 'https://hub.spigotmc.org/jenkins/job/spigot-essentials/lastSuccessfulBuild/artifact/Essentials/target/Essentials-2.x-SNAPSHOT.jar'
  servers 'test'
  action :install
end

# starts the server
minecraft_service 'test' do
  commands 'say Server is now online!'
  action :start
end

Dependent cookbooks

java ~> 1.42.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

minecraft-server cookbook changelog

Version 0.1.2 (9/15/2016)

  • Fix a bug causing the config not to update properly

Version 0.1.1 (9/9/2016)

  • Add support for installing Bukkit plugins from bukkit.org
  • Install plugins with links

Version 0.1.0 (9/4/2016)

  • Add support for vanilla Minecraft servers
  • Add support for Spigot/Bukkit servers

Collaborator Number Metric 
            
0.1.2 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Foodcritic Metric 
            
0.1.2 failed this metric
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/libraries/minecraft-server_web.rb:78
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/libraries/minecraft-server_web.rb:79
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:17
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:57
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:61
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:74
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:78
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:90
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:95
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:116
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:158
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:159
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:79
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:89
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:94
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:110
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:158
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:168
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:219
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:266
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:273
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_server.rb:277
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_yml.rb:72
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_yml.rb:76
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:129
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:139
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:144
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:160
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:208
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:214
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:269
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:316
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:323
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_server.rb:327
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/server_properties.rb:70
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/server_properties.rb:75
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:79
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:89
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:94
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:110
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:158
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:168
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:219
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:266
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:273
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_server.rb:277
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_yml.rb:72
FC002: Avoid string interpolation where not required: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_yml.rb:76
FC005: Avoid repetition of resource declarations: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:136
FC005: Avoid repetition of resource declarations: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_depend.rb:16
FC013: Use file_cache_path rather than hard-coding tmp paths: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_plugin.rb:58
FC013: Use file_cache_path rather than hard-coding tmp paths: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_plugin.rb:91
FC023: Prefer conditional attributes: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/build_tools.rb:100
FC023: Prefer conditional attributes: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_yml.rb:58
FC023: Prefer conditional attributes: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/bukkit_yml.rb:79
FC023: Prefer conditional attributes: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_yml.rb:58
FC023: Prefer conditional attributes: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/spigot_yml.rb:79
FC034: Unused template variables: /tmp/ceba99089f9d736c8280c718/minecraft-server/templates/default/minecraft.sh.erb:1
FC048: Prefer Mixlib::ShellOut: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_service.rb:32
FC048: Prefer Mixlib::ShellOut: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_service.rb:35
FC048: Prefer Mixlib::ShellOut: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_service.rb:54
FC048: Prefer Mixlib::ShellOut: /tmp/ceba99089f9d736c8280c718/minecraft-server/resources/minecraft_service.rb:57

John Harrison John Harrison

Details

View Source View Issues

Updated October 4, 2016 Created on

Supported Platforms

  • centos >= 0.0.0
  • ubuntu >= 0.0.0
  • redhat >= 0.0.0

License

Apache 2.0

Download Cookbook