mcblocky 0.1.0.pre.alpha.pre.6

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ODNmOWY2ZWVlZDliZmZlZGMzOGIxMjZjZjQxZjIwMGRhZGZlYTA3YQ==
+  data.tar.gz: !binary |-
+    NzMxM2ViNThiNjVkMzBmMjg4ZWNlYzNlOTY4ODg5OGViMTcwYzFlYQ==
+SHA512:
+  metadata.gz: !binary |-
+    NDg2YTg0MDQyNTg3MDU5MGZiYzQyNmRjODVhNDI0ZTYyYWZlZWQwZTA5OWVl
+    ZThjNDZlMTQzYjZiOTBhYjEwOTc0MTMwOWRkNzUzY2Q2Mjg5NTA3MzNhNmQ5
+    YWJhYmE4NDViMmQwZGFiNGVmMjdmNGFlMzI3YmI1YzE2N2ZjZDk=
+  data.tar.gz: !binary |-
+    MGIzN2MxNTJiZWE3NDZmMTNmNGNlMDZjOTg5ZjY3YTNmZDRiNWI0NDQ1MzNl
+    OGNlNzdlNjNkOGYyYWE0NDcwNzc5MGIwMmUxNjZmYTRlNjlhN2UyYzFmYWYz
+    ZDQ0YjM0YTQ2MTE0YjY0MmU2NmU5ZDk0ZjcyNjBlYjJhN2UzMmE=

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+config.yml
+/examples/*/server/

data/.travis.yml

@@ -0,0 +1,16 @@
+language: ruby
+rvm:
+- 2.3.0
+- 2.2.4
+- 2.1.8
+- 2.0.0
+before_install:
+- gem install bundler
+- bundle --version
+deploy:
+  provider: rubygems
+  api_key:
+    secure: d2sBTznIo/xcoSPAvPCGrizeQlvVQOh2Vma6GK/vZrM4EiOjzQTe8UB21WiOHjoPejI1+wi1V+Vf4Ule4K01xzQDrL6DdcdNSplmrS73GPYDEcYJMQcRUkup1WNpUsO0z1gpiw6eKDVObyxtnFjH1cwU4mDkip9NiPhrGbig5rEn0EUJkQxWn3QHHp/IfwOBagIjLecFTP27A/diWsdlkIzBt9TS1HsKUx7dF7ktJQIgbgXCgD4Rr2PfrelsPA6e5vrSvxo8ORr6j978N8ZPpDSZtBQbDR7i4KA8WYr4cprDa6PEhGMMvTb1b7mBoXnbfTPCgJcWVB0/Y9A4qlV9pcU+nEb9hN6E8CcvtgvmBYDD4PUAj0gE8nGg9eO84VrII7KaZRJkGXITR9kpNaglZrwyncOZ3tt8AV7Ee46VEpSGNlWXZdFRm4i1QKnE0iExPB1UOiLjpFjspljTzCHV4tt5s+eEthTx4Lqw3iqBqpcn/bpVOXypCxSkr0AfM2xSGFG27ItDy0i2K+evOKlIlRu0AFGhhHlBpkccOxW9I7SmY2LW9jrvSV8HBp6msrnncQOfGaA61bgQy9o8qKTDGeJ4p3MyhOSV7aSHFNSdo9/7f26G+jH/CZnk8lsN5RfY1X8v3kJxZX7eB+lcaV/oyHr5Q95+vkBuW92oHb6uxec=
+  gem: mcblocky
+  on:
+    repo: DeltaWhy/mcblocky

data/Gemfile

@@ -0,0 +1,4 @@
+source "https://rubygems.org"
+
+gemspec
+gem "wdm" if Gem.win_platform?

data/README.md

@@ -0,0 +1,34 @@
+# McBlocky
+
+McBlocky is a Ruby DSL for creating Minecraft command block contraptions and
+maps.
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [Development](#development)
+- [Contributing](#contributing)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## Installation
+
+    $ gem install mcblocky
+
+## Usage
+
+See [the documentation](doc/Introduction.md).
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/DeltaWhy/mcblocky.
+

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "mcblocky"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/bin/workon.cmd

@@ -0,0 +1 @@
+doskey mcblocky=set BUNDLE_GEMFILE=%CD%\Gemfile ^& bundle exec ruby %CD%\exe\mcblocky $1 $2 $3 $4 $5 $6 $7 $8 $9

data/doc/Introduction.md

@@ -0,0 +1,144 @@
+
+# McBlocky
+McBlocky is a Ruby DSL for creating Minecraft command block contraptions and maps. It allows you to write Ruby code that gets translated into commands and command blocks in the Minecraft world. Because it does everything by executing commands in the server console, you can see the results of your changes in-game almost immediately after you hit 'Save' in your editor -- no need to restart the server to run MCEdit.
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+
+- [Getting Started](#getting-started)
+- [Basic commands](#basic-commands)
+- [Leveraging Ruby](#leveraging-ruby)
+- [Placing blocks](#placing-blocks)
+- [Command chains](#command-chains)
+- [Next steps](#next-steps)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
+## Getting Started
+To start your project, you first need to create a `config.yml` that tells McBlocky how to run the server. See an example [here](../examples/ctf/config.example.yml). Next, create your main Ruby file. By default McBlocky will look for a `.rb` file with the same name as the folder containing your `config.yml`, but you can specify another name if you prefer.
+
+Let's start with an empty file called `hello.rb`. Now, start the server:
+```
+mcblocky start path/to/config.yml
+```
+If you've gotten your configuration right, you should see this message:
+```
+---> Server is ready! Connect to 127.0.0.1:25565
+```
+Start up Minecraft and connect to the server so you can see your changes in real time. You can stop the server by pressing `CTRL-C` or running the `stop` command in the console (other server commands work too).
+
+## Basic commands
+Add this to `hello.rb`:
+```ruby
+initial do
+  say 'Hello', @p
+end
+```
+When you save the file, you should see `Reloading...` in the McBlocky console and a greeting in-game. This is not terribly exciting, so let's do some useful setup.
+```ruby
+initial do
+  say 'Hello', @p
+  time :set, :day
+  gamerule :doDaylightCycle, false
+end
+```
+You should notice that the server doesn't greet you again. McBlocky tries to avoid redoing work where possible, so it will skip the first command since it has already run. If you add more commands onto the end of the `initial` block, only the new commands get executed, but if you add them in the middle, it will execute everything after the first change since it can't tell which commands might depend on each other.
+
+## Leveraging Ruby
+Let's create some teams for a minigame.
+```ruby
+initial do
+  scoreboard :teams, :add, 'Red'
+  scoreboard :teams, :option, 'Red', :color, 'red'
+  scoreboard :teams, :add, 'Blue'
+  scoreboard :teams, :option, 'Blue', :color, 'blue'
+  scoreboard :teams, :add, 'Yellow'
+  scoreboard :teams, :option, 'Yellow', :color, 'yellow'
+  scoreboard :teams, :add, 'Green'
+  scoreboard :teams, :option, 'Green', :color, 'green'
+end
+```
+Hmm, this is a bit repetitive isn't it? Fortunately there is a shorthand for `scoreboard`:
+```ruby
+initial do
+  scoreboard :teams do
+    add 'Red'
+    option 'Red', :color, 'red'
+    add 'Blue'
+    option 'Blue', :color, 'blue'
+    add 'Yellow'
+    option 'Yellow', :color, 'yellow'
+    add 'Green'
+    option 'Green', :color, 'green'
+  end
+end
+```
+This is a more readable but if we wanted more than four teams it would still be a bit unwieldy. But since this is just Ruby code, we can use an `each` loop instead of repeating ourselves.
+```ruby
+initial do
+  ['red', 'blue', 'yellow', 'green'].each do |color|
+    scoreboard :teams do
+      add color.capitalize
+      option color.capitalize, :color, color
+    end
+  end
+end
+```
+All three snippets are equivalent, so you can use whichever form you prefer.
+
+## Placing blocks
+Initial commands are useful for setting up the scoreboard and gamerules, but to do anything interesting we'll need some command blocks. You can use a `setblock` command (outside of the `initial` block) to place one. Let's give it a button too. (Change the coordinates to somewhere above ground and close to your player).
+```ruby
+setblock -89, 34, -95, 'minecraft:command_block', 0, :replace, {Command: 'say Hello @p'}
+setblock -90, 34, -95, 'minecraft:stone_button', 2
+```
+Try commenting out one of these lines -- you'll notice McBlocky tries to clean up after itself by setting the block back to air. You can set any block this way, but there is a shorthand for command blocks:
+```ruby
+at -89, 34, -95 do
+  say 'Hello', @p
+end
+```
+You can also set the direction, type, and NBT tags of the command block:
+```ruby
+at -89, 34, -95, Facing::EAST, :repeating, {auto: 1} do
+  say 'Hello', @p
+end
+```
+Try out the `fill` command (outside of the `initial` block) too.
+
+## Command chains
+Of course, we don't really want to specify the position and data tags of every command block individually, we just want to write code and have it do cool stuff! For the common pattern of an always-on repeating command block followed by always-on chain command blocks, we can just specify a bounding box and let McBlocky handle the rest.
+
+Let's create some pads that players can step on to join a team.
+```ruby
+# ...scoreboard setup omitted
+
+setblock -5, 34, 0, 'minecraft:wool', Color::RED
+setblock 5, 34, 0, 'minecraft:wool', Color::BLUE
+
+# use an underground area that's much bigger than we really need
+repeat -5, 5, -5, 5, 10, 5 do
+  scoreboard :players, :set, @a[x: -5, y: 35, z: 0, r: 1, team: '!Red'], 'SwitchingTeam', 1
+  scoreboard :players, :set, @a[x: 5, y: 35, z: 0, r: 1, team: '!Blue'], 'SwitchingTeam', 1
+  
+  execute @a[x: -5, y: 35, z: 0, r: 1, score_SwitchingTeam_min: 1] do
+    scoreboard :teams, :join, 'Red', @p
+    tellraw @a, {selector: @p}, {text: ' joined the ', color: 'reset'}, {text: 'Red team', color: 'red'}
+  end
+
+  execute @a[x: 5, y: 35, z: 0, r: 1, score_SwitchingTeam_min: 1] do
+    scoreboard :teams, :join, 'Blue', @p
+    tellraw @a, {selector: @p}, {text: ' joined the ', color: 'reset'}, {text: 'Blue team', color: 'blue'}
+  end
+  
+  scoreboard :players, :reset, @a, 'SwitchingTeam'
+end
+```
+
+## Next steps
+Check out the [examples folder](../examples) for some longer examples. Then try making one of your own! Also have a look at the rest of the [documentation](../doc) *(coming soon)*.
+
+Please report bugs and feature requests on the [issue tracker](https://github.com/DeltaWhy/mcblocky/issues). I will also accept pull requests for the code, documentation, and examples.
+
+If you build a map with this, I'd love to hear about it! Drop me a line on Twitter [@michaellimiero](https://twitter.com/michaellimiero) and I'll add a link to your project in the README.

data/examples/ctf/arena.rb

@@ -0,0 +1,14 @@
+fill 0, 32, 0, 50, 32, 24, 'minecraft:stone'
+fill 0, 33, 0, 50, 33, 24, 'minecraft:grass'
+fill -1, 32, -1, 51, 52, -1, 'minecraft:stonebrick'
+fill -1, 32, 25, 51, 52, 25, 'minecraft:stonebrick'
+fill -1, 32, -1, -1, 52, 25, 'minecraft:stained_hardened_clay', Color::RED
+fill 51, 32, -1, 51, 52, 25, 'minecraft:stained_hardened_clay', Color::BLUE
+
+fill 0, 33, 10, 0, 33, 14, 'minecraft:stained_hardened_clay', Color::RED
+fill 1, 33, 11, 1, 33, 13, 'minecraft:stained_hardened_clay', Color::RED
+setblock 0, 33, 12, 'minecraft:gold_block'
+
+fill 50, 33, 10, 50, 33, 14, 'minecraft:stained_hardened_clay', Color::BLUE
+fill 49, 33, 11, 49, 33, 13, 'minecraft:stained_hardened_clay', Color::BLUE
+setblock 50, 33, 12, 'minecraft:gold_block'

data/examples/ctf/config.example.yml

@@ -0,0 +1,15 @@
+server:
+  # If java is not on your $PATH you must set this
+  # java: path/to/java
+  jar: path/to/minecraft_server.1.9.jar
+  workdir: server
+  ops:
+    - DeltaWhy
+  eula: true
+  properties:
+    gamemode: 2
+    motd: McBlocky Capture the Flag
+    generator-settings: '3;minecraft:air;127;decoration;2;'
+code:
+  # Defaults to the name of the directory
+  # main: ctf.rb

data/examples/ctf/ctf.rb

@@ -0,0 +1,316 @@
+# Capture the Flag
+#
+# Made for 1.9 void world preset
+
+red_spawn = Location.new(0, 34, 12)
+blue_spawn = Location.new(50, 34, 12)
+
+helper 'clean' do |args, user|
+  Executor.to_commands($context).each{|c| server.command c}
+end
+
+helper 'blue' do |args, user|
+  user = user.gsub(/[^A-Za-z0-9_]./, '')
+  server.command "scoreboard teams join Blue #{user}"
+end
+
+helper 'red' do |args, user|
+  user = user.gsub(/[^A-Za-z0-9_]./, '')
+  server.command "scoreboard teams join Red #{user}"
+end
+
+helper 'reset' do |args, user|
+  server.command "scoreboard players set @a GAME 1"
+end
+
+initial do
+  time :set, 'day'
+  gamerule :doDaylightCycle, false
+  gamerule :logAdminCommands, false
+  gamerule :commandBlockOutput, false
+  weather :clear, 999999
+
+  scoreboard :teams do
+    add 'Red'
+    option 'Red', :color, 'red'
+    add 'Blue'
+    option 'Blue', :color, 'blue'
+    join 'Red', '--RED--'
+    join 'Blue', '--BLUE--'
+    add 'Spectators'
+  end
+
+  scoreboard :objectives do
+    add 'LOGIN', :dummy
+    add 'GAME', :dummy
+    add 'SwitchingTeam', :dummy
+    add 'Score', :dummy
+    add 'CapturingFlag', :dummy
+    add 'CapturingOwnFlag', :dummy
+    add 'HasFlag', :dummy
+    add 'HasOwnFlag', :dummy
+    add 'ReturningFlag', :dummy
+    add 'ReturningOwnFlag', :dummy
+    add 'IsDead', :deathCount
+  end
+end
+
+# login
+repeat -8, 6, -8, 8, 8, -8 do
+  scoreboard :players, :add, @a, 'LOGIN', 0
+  tp @a[score_LOGIN:0], -95, 33, -95
+  clear @a[score_LOGIN:0]
+  scoreboard :teams, :join, 'Spectators', @a[score_LOGIN:0]
+  tellraw @a[score_LOGIN:0], [
+    {text: "Welcome to ", color: "gold"},
+    {text: "McBlocky ", color: "aqua"},
+    {text: "C", color: "red"},
+    {text: "T", color: "green"},
+    {text: "F", color: "blue"},
+    {text: "!", color: "gold"}
+  ]
+  scoreboard :players, :set, @a[score_LOGIN:0], 'LOGIN', 1
+end
+
+# room construction
+require_relative 'arena'
+require_relative 'lobby'
+
+# team join/leave
+repeat 10, 6, -8, 24, 8, -8 do
+  scoreboard :players do
+    set @a[team: '!Red', x: -95, y: 33, z: -102, r:4], 'SwitchingTeam', 1
+    set @a[team: '!Blue', x: -95, y: 33, z: -88, r:4], 'SwitchingTeam', 1
+    set @a[team: '!Spectators', x: -102, y: 33, z: -95, r: 4], 'SwitchingTeam', 1
+  end
+  scoreboard :teams do
+    join 'Red', @a[team: '!Red', x: -95, y: 33, z: -102, r:4]
+    join 'Blue', @a[team: '!Blue', x: -95, y: 33, z: -88, r:4]
+    join 'Spectators', @a[team: '!Spectators', x: -102, y: 33, z: -95, r: 4]
+  end
+  execute @a[score_SwitchingTeam_min:1, team: 'Red'] do
+    tellraw @a, {selector: "@p"},
+      {text: " joined the ", color: "reset"},
+      {text: "Red", color: "red"},
+      {text: " team", color: "reset"}
+  end
+  execute @a[score_SwitchingTeam_min:1, team: 'Blue'] do
+    tellraw @a, {selector: "@p"},
+      {text: " joined the ", color: "reset"},
+      {text: "Blue", color: "blue"},
+      {text: " team", color: "reset"}
+  end
+  execute @a[score_SwitchingTeam_min:1, team: 'Spectators'] do
+    tellraw @a, {selector: "@p"},
+      {text: " is now spectating", color: "reset"}
+  end
+  scoreboard :players, :reset, @a[score_SwitchingTeam_min:1], 'SwitchingTeam'
+end
+
+# game start
+repeat -8, 6, -6, 8, 8, -6 do
+  a = @a[score_GAME_min:1]
+  p = @p[score_GAME_min:1]
+
+  gamemode 3, a[team:'Spectators']
+  gamemode 2, a[team:'!Spectators']
+  tp a[team:'Red'], 0, 34, 12, 270, 0
+  tp a[team:'Blue'], 50, 34, 12, 90, 0
+  tp a[team:'Spectators'], 25, 38, 12
+  clear a
+  replaceitem :entity, a[team:'Red'], 'slot.armor.chest', 'minecraft:leather_chestplate', 1, 0, {display:{color:10040115}}
+  replaceitem :entity, a[team:'Blue'], 'slot.armor.chest', 'minecraft:leather_chestplate', 1, 0, {display:{color:3361970}}
+
+  execute p do
+    scoreboard :objectives, :setdisplay, :sidebar, 'Score'
+    fill 0, 34, 0, 50, 36, 24, 'minecraft:air', 0, :replace, 'minecraft:standing_banner'
+    setblock 0, 34, 12, 'minecraft:standing_banner', 12
+    blockdata 0, 34, 12, {Base: 1}
+    setblock 50, 34, 12, 'minecraft:standing_banner', 4
+    blockdata 50, 34, 12, {Base: 4}
+    %w(HasFlag HasOwnFlag CapturingFlag CapturingOwnFlag ReturningFlag ReturningOwnFlag).each do |s|
+      scoreboard :players, :reset, @a, s
+    end
+    scoreboard :players, :reset, '*', 'Score'
+    scoreboard :players, :set, '--RED--', 'Score', 0
+    scoreboard :players, :set, '--BLUE--', 'Score', 0
+  end
+
+  effect a, 'minecraft:saturation', 1, 99
+  effect a, 'minecraft:instant_health', 1, 99
+  spawnpoint a[team:'Red'], 0, 34, 12
+  spawnpoint a[team:'Blue'], 50, 34, 12
+  scoreboard :players, :reset, @a, 'GAME'
+end
+
+# pick up enemy flag
+repeat 10, 6, -6, 24, 8, -6 do
+  detect @a[team:'Red'], '~ ~ ~', 'minecraft:standing_banner', 4 do
+    scoreboard :players, :set, @p, 'CapturingFlag', 1
+  end
+  detect @a[team:'Blue'], '~ ~ ~', 'minecraft:standing_banner', 12 do
+    scoreboard :players, :set, @p, 'CapturingFlag', 1
+  end
+  red = @p[team:'Red', score_CapturingFlag_min:1]
+  blue = @p[team:'Blue', score_CapturingFlag_min:1]
+
+  execute red do
+    tellraw @a, {selector: "@p"},
+      {text: " got the ", color: "reset"},
+      {text: "Blue Flag", color: "blue"}
+  end
+  replaceitem :entity, red, 'slot.armor.head', 'minecraft:banner', 1, 4
+  execute blue do
+    tellraw @a, {selector: "@p"},
+      {text: " got the ", color: "reset"},
+      {text: "Red Flag", color: "red"}
+  end
+  replaceitem :entity, blue, 'slot.armor.head', 'minecraft:banner', 1, 1
+
+  execute @a[score_CapturingFlag_min:1] do
+    setblock '~ ~ ~', 'minecraft:air'
+    scoreboard :players, :set, @p, 'HasFlag', 1
+    scoreboard :players, :reset, @p, 'CapturingFlag'
+  end
+end
+
+# capture enemy flag
+repeat -8, 6, -4, 8, 8, -4 do
+  detect @p[team:'Red', score_HasFlag_min:1, loc: red_spawn, r: 1], '~ ~ ~', 'minecraft:standing_banner', 12 do
+    scoreboard :players, :set, @p, 'ReturningFlag', 1
+  end
+  detect @p[team:'Blue', score_HasFlag_min:1, loc: blue_spawn, r: 1], '~ ~ ~', 'minecraft:standing_banner', 4 do
+    scoreboard :players, :set, @p, 'ReturningFlag', 1
+  end
+  red = @p[team:'Red', score_ReturningFlag_min:1]
+  blue = @p[team:'Blue', score_ReturningFlag_min:1]
+
+  execute red do
+    title @a, :title, {text: "Score", color: "red"}
+    title @a, :subtitle,
+      {selector: "@p"},
+      {text: " captured the flag", color: "reset"}
+  end
+
+  execute blue do
+    title @a, :title, {text: "Score", color: "blue"}
+    title @a, :subtitle,
+      {selector: "@p"},
+      {text: " captured the flag", color: "reset"}
+  end
+
+  # reset the flag
+  execute red do
+    setblock 50, 34, 12, 'minecraft:standing_banner', 4
+    blockdata 50, 34, 12, {Base: 4}
+  end
+  execute blue do
+    setblock 0, 34, 12, 'minecraft:standing_banner', 12
+    blockdata 0, 34, 12, {Base: 1}
+  end
+  replaceitem :entity, @a[score_ReturningFlag_min:1], 'slot.armor.head', 'minecraft:air'
+
+  # scores
+  execute red do
+    scoreboard :players, :add, '--RED--', 'Score', 1
+  end
+  execute blue do
+    scoreboard :players, :add, '--BLUE--', 'Score', 1
+  end
+  scoreboard :players, :add, @a[score_ReturningFlag_min:1], 'Score', 1
+  execute @a[score_ReturningFlag_min:1] do
+    scoreboard :players, :reset, @p, 'HasFlag'
+    scoreboard :players, :reset, @p, 'ReturningFlag'
+  end
+end
+
+# drop flag on death
+repeat 10, 6, -4, 24, 8, -4 do
+  # only @a includes dead players
+  red = @a[score_IsDead_min:1, score_HasFlag_min:1, team: 'Red']
+  blue = @a[score_IsDead_min:1, score_HasFlag_min:1, team: 'Blue']
+
+  execute red do
+    tellraw @a, {selector: red},
+      {text: " dropped the ", color: "reset"},
+      {text: "Blue Flag", color: "blue"}
+  end
+  execute blue do
+    tellraw @a, {selector: blue},
+      {text: " dropped the ", color: "reset"},
+      {text: "Red Flag", color: "red"}
+  end
+  execute red do
+    setblock '~ ~ ~', 'minecraft:standing_banner', 4
+    blockdata '~ ~ ~', {Base: 4}
+  end
+  execute blue do
+    setblock '~ ~ ~', 'minecraft:standing_banner', 12
+    blockdata '~ ~ ~', {Base: 1}
+  end
+
+  scoreboard :players, :reset, @a[score_IsDead_min:1], 'HasFlag'
+  scoreboard :players, :reset, @a[score_IsDead_min:1], 'HasOwnFlag'
+  scoreboard :players, :reset, @a[score_IsDead_min:1], 'IsDead'
+end
+
+# pick up own flag
+repeat -8, 6, -2, 8, 8, -2 do
+  detect @a[team:'Blue'], '~ ~ ~', 'minecraft:standing_banner', 4 do
+    scoreboard :players, :set, @p, 'CapturingOwnFlag', 1
+  end
+  detect @a[team:'Red'], '~ ~ ~', 'minecraft:standing_banner', 12 do
+    scoreboard :players, :set, @p, 'CapturingOwnFlag', 1
+  end
+  # can't pick up own flag when it's at base
+  detect @a[score_CapturingOwnFlag_min:1], '~ ~-1 ~', 'minecraft:gold_block', 0 do
+    scoreboard :players, :reset, @p, 'CapturingOwnFlag'
+  end
+  blue = @p[team:'Blue', score_CapturingOwnFlag_min:1]
+  red = @p[team:'Red', score_CapturingOwnFlag_min:1]
+
+  execute blue do
+    tellraw @a, {selector: "@p"},
+      {text: " got the ", color: "reset"},
+      {text: "Blue Flag", color: "blue"}
+  end
+  replaceitem :entity, blue, 'slot.armor.head', 'minecraft:banner', 1, 4
+  execute red do
+    tellraw @a, {selector: "@p"},
+      {text: " got the ", color: "reset"},
+      {text: "Red Flag", color: "red"}
+  end
+  replaceitem :entity, red, 'slot.armor.head', 'minecraft:banner', 1, 1
+  execute @a[score_CapturingOwnFlag_min:1] do
+    setblock '~ ~ ~', 'minecraft:air'
+    scoreboard :players, :set, @p, 'HasOwnFlag', 1
+    scoreboard :players, :reset, @p, 'CapturingOwnFlag'
+   end
+end
+
+# return own flag
+repeat 10, 6, -2, 24, 8, -2 do
+  execute @a[team:'Blue', loc: blue_spawn, r: 1, score_HasOwnFlag_min: 1] do
+    scoreboard :players, :set, @p, 'ReturningOwnFlag', 1
+  end
+  execute @a[team:'Red', loc: red_spawn, r: 1, score_HasOwnFlag_min: 1] do
+    scoreboard :players, :set, @p, 'ReturningOwnFlag', 1
+  end
+  execute @a[team:'Blue',score_ReturningOwnFlag_min:1] do
+    setblock 50, 34, 12, 'minecraft:standing_banner', 4
+    blockdata 50, 34, 12, {Base: 4}
+    tellraw @a, {selector: "@p"},
+      {text: " returned the ", color: "reset"},
+      {text: "Blue Flag", color: "blue"}
+  end
+  execute @a[team:'Red',score_ReturningOwnFlag_min:1] do
+    setblock 0, 34, 12, 'minecraft:standing_banner', 12
+    blockdata 0, 34, 12, {Base: 1}
+    tellraw @a, {selector: "@p"},
+      {text: " returned the ", color: "reset"},
+      {text: "Red Flag", color: "red"}
+  end
+  replaceitem :entity, @a[score_ReturningOwnFlag_min:1], 'slot.armor.head', 'minecraft:air'
+  scoreboard :players, :reset, @a[score_ReturningOwnFlag_min:1], 'HasOwnFlag'
+  scoreboard :players, :reset, @a[score_ReturningOwnFlag_min:1], 'ReturningOwnFlag'
+end

data/examples/ctf/lobby.rb

@@ -0,0 +1,20 @@
+fill -100, 32, -100, -90, 32, -90, 'minecraft:log'
+fill -101, 33, -101, -89, 34, -101, 'minecraft:barrier'
+fill -101, 33, -89, -89, 34, -89, 'minecraft:barrier'
+fill -101, 33, -100, -101, 34, -90, 'minecraft:barrier'
+fill -89, 33, -100, -89, 34, -90, 'minecraft:stained_hardened_clay', Color::LIGHT_BLUE
+
+setblock -95, 32, -95, 'minecraft:glowstone'
+setblock -89, 34, -95, 'minecraft:wool', Color::LIME
+setblock -90, 34, -95, 'minecraft:stone_button', 2
+setblock -90, 33, -95, 'minecraft:wall_sign', Facing::WEST, 'replace', {'Text2'=>'{"text":"Start Game"}'}
+at -88, 34, -95 do
+  scoreboard :players, :set, @a, 'GAME', 1
+end
+
+fill -100, 32, -92, -100, 32, -98, 'minecraft:wool', Color::WHITE
+fill -99, 32, -93, -99, 32, -97, 'minecraft:wool', Color::WHITE
+fill -92, 32, -100, -98, 32, -100, 'minecraft:wool', Color::RED
+fill -93, 32, -99, -97, 32, -99, 'minecraft:wool', Color::RED
+fill -92, 32, -90, -98, 32, -90, 'minecraft:wool', Color::BLUE
+fill -93, 32, -91, -97, 32, -91, 'minecraft:wool', Color::BLUE

data/examples/hello/config.example.yml

@@ -0,0 +1,14 @@
+server:
+  # If java is not on your $PATH you must set this
+  # java: path/to/java
+  jar: path/to/minecraft_server.1.9.jar
+  workdir: server
+  ops:
+    - DeltaWhy
+  eula: true
+  properties:
+    gamemode: 1
+    motd: McBlocky Hello World
+code:
+  # Defaults to the name of the directory
+  # main: hello.rb