Baratza Rescues My Starbucks Grinder… Again!

Starbucks EL60 Grinder Jammed

The Starbucks “Barista” Coffee Grinder, the EL60, is the grinder that just won’t die. It was a present from my beautiful, amazing wife many years ago, and it has truly been a gift that keeps on giving.

Now.. it’s survival isn’t just amazing because it’s really well made. It’s amazing because it continues to chug away despite years of abuse on my part! I’ve written previously about how Baratza helped me replace my broken hopper after the whole grinder took a nasty fall.

This time, it turns out that my fundamental ignorance of how the thing works allowed me to neglect basic maintenance to the point that it became nearly unusable. Here’s what happened.

One day not long ago, I dumped the coffee grounds from the EL60’s bin into my pour over and noticed that it seemed a little light. After years of doing this, I should’ve realized that my instincts were spot on and I was missing some grounds, but I didn’t think too much about it. That cup of coffee brewed up super quick, and was naturally quite weak.

I still didn’t think a whole lot about it until I went on to brew the next cup, and ground up some more beans. This time, the grinder just didn’t seem to ever finish grinding. I’m so in tune with the sound of this thing that the pitch it generates when the RPMs spin up to their max is my aural clue that the grind is complete.

So… I dumped the bin again, and this time I only got a few grounds and some powder.

Powder is a problem. This grinder is known for producing a highly uniform grind… especially for a consumer unit sold en masse by Starbucks.

So… I took the hopper off and peered into the grinder only to discover that there were still nearly untouched coffee beans in the works.

Disassembly from there was a little harder than it should’ve been, mainly due to the aforementioned years of neglect.

But… once I finally got the ring burr to let go of its grip on the holder for the main burr (below), I saw that the entire chamber was full of grinds and shards of beans.

Right away I knew that the motor was fine. It was chugging away just perfectly. The burrs themselves were still sharp—after all, I was getting grinds that were what I expected… plus powder! So that meant that something mechanical was out of whack.

After spending several days cleaning out the grinder chamber with a butter knife after each grind, I decided to completely disassemble the machine and see if I could figure out what was going on.

Here’s what I found:

Starbucks Grinder: Jammed with Coffee Grounds

That little black component is a “door” of sorts, which opens to allow the coffee grinds to escape from the grinding chamber into the little chute which feeds the bin. As you can see, the “doorway” is jammed with grinds… and powdery ones.

Since I’m grinding for a pour-over brewing method and not for espresso, you can imagine that I do not usually grind the beans to powder. So this was all quite mystifying to me.

So… I did what had worked well for me in the past, and reached out via email to Pierce Jens, who has provided outstanding support for me in the past.

Pardon Me While I Rave About Baratza

I’ll get back to the story (and the fix for my grinder) in a moment. But first let me insert a couple of thoughts about Baratza.

Baratza is a company I can get excited about. When I first needed help with my grinder some years ago, I was directed to Baratza by Solis, the European manufacturer that originally built my grinder, with instructions that Baratza was their US distributor and was responsible for support.

It’s unclear to me whether Baratza had anything to do with the original deal that allowed for Starbucks to private label the Solis grinder and distribute it in the US under the “Starbucks Barista” brand when my wife bought this grinder for me many years ago.

What is clear is that Baratza is currently the major supplier for Starbucks grinders, and that those grinders sold by Starbucks wear the Baratza label rather than a Starbucks private label.

So… maybe they made a little money on the original purchase of my grinder, maybe they didn’t. Even if they did, they were a distant 3rd party to the transaction and were completely unknown to consumers like me at the time.

In other words, they could have easily declined to expend any resources on supporting me with my grinder problems. This they did not do.

Additionally, Baratza has advocated quite publicly for keeping grinders out of landfills, a message which, as a jaded marketer, I’ll admit to being a little dubious about. After all, it’s easy to talk about concern for the environment, and it’s another thing entirely to align one’s business practices around it.

In the case of Baratza, I can tell you that they have proven to me through my interactions with them that repairing coffee grinders—whether to keep them out of landfills or to provide outstanding customer service or both—is something that their business practices fully support.

This is impressive.

OK… back to my story.

The Fix for My Jammed Grinder

I found an old email thread from when Pierce Jens, who is a support technician at Baratza, helped me figure out what to do with my broken hopper, and replied to it, including the photo above showing my grinder jammed with coffee grounds.

Ever the master of email support, Pierce waded through the superfluous details I provided and managed to troubleshoot the issue in one round:

Hi David,

Thank you for your kind words! I’m always happy to help troubleshoot, let’s see if we can figure this out. I think you may simply have a worn out paddle wheel. Check out the 3rd picture of the Troubleshoot guide attached. None of the other pictures apply to your machine. You should have an 8 blade paddle, and I suspect yours is worn all the way out. I also have the paddle wheel replacement guide attached and the part is $5 on our Solis parts page.

By the way, your write up about the hopper has made several fellow EL60 owners happy over the years: kudos for that!

What was funny to me was that I had spotted the paddle wheel on the Solis Grinder Parts page on the Baratza website, but assumed that it applied to a different grinder than mine… because I didn’t recognize it!

I knew right away that he was right. So… I placed the order. Within a couple of days, the new part had arrived and I disassembled the grinder once again.

Conical Burr from Starbucks EL60 Grinder
Conical Burr from Starbucks EL60 Grinder

In the photo, there’s the conical burr from my grinder, which I got removed from the machine according to the directions that Pierce provided.

There’s an 8 blade plastic paddle below there… can you see it?

I couldn’t either. Here’s why:

Conical Burr with Worn Paddle Wheel Blades
Conical Burr with Worn Paddle Wheel Blades

Sure enough, the blades were completely worn, which is why I didn’t recognize the part on their website!

The paddle wheel is responsible for sweeping the grounds out of the grinding chamber and through the shoot to the bin. After many years of use (in my case, anyway), the blades had worn down to the point where they just couldn’t push and grinds out!

I got the new one out of the package and attached it to the burr. Check out the worn one in the background!

New paddle wheel attached to the conical burr
New paddle wheel attached to the conical burr

Reassembly was a snap. The PDF guides Pierce sent me had plenty of detailed instructions and the whole repair probably took less than 10 minutes.

With the grinder back together, I’m now getting “good as new” performance from my machine.

A couple of lessons learned:

  1. I probably should take a cleaning brush to the burrs on a regular basis. I will admit to having lost my grinder brush many years ago and then forgetting about this whole maintenance step. Had I been doing this, I probably would have noticed the paddles wearing down. In my case, it had been so long since I had had the grinder apart (even enough to just inspect the burrs), that I had completely forgotten those white paddles had ever been there!
  2. Baratza has won my business. They make virtually nothing from selling me parts like this, because the resources they’ve expended to provide support are far costlier than the revenue they’ve generated from the parts (not to mention the profits). That they still provide support via email in this way, and that there’s someone smart enough to employ Pierce Jens tells me that they’re precisely the sort of company I want to do business with.
  3. The final lesson is that I’m probably going to go ahead and order new burrs for my machine as the supply of parts for my grinder is apparently starting to dwindle. Mine are still performing well, but after inspecting them up close, I could definitely see signs of wear that weren’t visible to me prior to completely disassembling the grinder.

Alas… I won’t be needing a new grinder any time soon. But when I do, I’ll be buying Baratza. I certainly highly recommend you do the same!

Oh… and if you’re having trouble with any Baratza grinders, check out their fantastic YouTube channel, where Pierce shows how to perform any number of repairs!

KidsCamp at WordCamp Tampa 2016

Grace working on her blog at KidsCamp #WCTPA 2016

Earlier this week, I mentioned WordCamp to my amazing, talented, brilliant daughter, Grace. I was pleasantly surprised to discover that she seemed interested in going!

So… here we are at the beautiful Marshall Student Center on the USF campus with quite an assortment of WordPress enthusiasts. We opted to check out KidsCamp, and in less than an hour, Grace is already busily crafting her first ever blog post!

Preventing Zika Virus in Florida

Recent reporting from Kaiser Health News, WLRN & the Miami Herald reveals that

  • At least 55 pregnant women in Florida have tested positive for Zika Virus, all of whom were apparently infected while traveling outside the US
  • The number of cases of Zika virus transmission from Florida mosquitoes now stands at 15
  • At least one child has been born in Florida with microcephaly, one of the potential birth anomalies that has been tied to Zika virus.

See the article “Zika Is ‘Game-Changer’ For OB-GYN Doctors In Florida” for full details.

Obviously, the presence of Zika in Florida is troubling, and is provoking all sorts of response from the healthcare community as well as public officials.

Ways to Avoid Mosquito-Borne Illnesses

The inherent problem with much of the response being debated is that solutions like a “vaccine” will require significant time for research and trials to run their course, and then can be problematic in and of themselves.

In the absence of preventive measures from medicine, prevention of mosquito-borne illnesses like Zika virus comes down to just a few basic methods.

  1. Avoid Mosquitoes
  2. Repel Mosquitoes
  3. Prevent the Mosquitoes from Biting

The first 2 options are pretty obvious. To avoid mosquitoes, you can stay away from any areas of the State of Florida where standing water may be. In light of our recent weather, this will likely mean leaving the state altogether or just staying indoors. Repelling mosquitoes is a little bit more problematic, as products like DEET, which experts seem to agree is one of the most effective mosquito repellents, are more and more problematic as new research comes to light.

The 3rd option, however, is a new one. And it’s very intriguing.

A Sarasota, Florida company called Penta Five USA, LLC has developed a method that that apparently causes female mosquitoes to be repulsed at the thought of ingesting blood from mammals. Think of it as the mosquito equivalent of having your stomach turn at the thought of certain foods you can’t stand. The company claims that its product will have this affect on any mosquitoes within a certain radius of the location where their product is installed in any outdoor area.

Sarasota-based Good News Pest Solutions is the exclusive service provider for this product. Owner Dean Burnside can now be seen on local television touting the formula as all-natural (“organic” even!) and not harmful to the mosquitoes. It turns out that mosquitoes are natural pollinators (who knew?) and only the females bite mammals or crave blood at all, and then only when they have eggs to lay. When they encounter this product, they are said to be interested only in the fructose that they would normally ingest during pollination.

More details on the Mosquito Protection Program from Good News Pest Solutions can be found here.

NoBiteZones.com

Congratulations to our friends at Good News Pest Solutions on the launch of their new Mosquito Protection Program. Their new service actually changes the behavior of the mosquitoes within a certain radius, which prevents them from even wanting to bite humans or pets! Amazing!

No Soliciting: Should Candidates for Office Go Door-to-Door?

No Soliciting Sign - Photo: Marcus Quigmire via Flickr

He knocked on our door around mid-day on a quiet Saturday—something that almost never happens in our neighborhood.

Thankfully, I had the advantage of being able to see him through the glass panes of our front door. I knew several things about him at once: he wasn’t one of our neighbors or friends (any friends of ours would’ve called first, of course), he was well-groomed and neatly dressed (casual, but put-together), and bore all the outward signs of being a respectable human being.

But… as someone who takes the safety of his family very seriously, I know that outward appearances can be deceiving.

  • Does he have “pals” waiting in the bushes just beyond my view?
  • Is he a sex offender?
  • Is he here to see whether I have kids?
  • He can see through the glass panes just like I can… is he here to case the joint? Should I have a weapon when I approach the door?

Mind you… I live in a solidly middle-class suburban neighborhood. It’s not a gated community, so perhaps if he were here with some sort of evil or malicious intent, he might’ve chosen a different neighborhood.

And he might’ve chosen a weekday when we aren’t likely to be home.

But still… there are types (pedophiles, for example) that are looking for homes with kids when everyone is at home so they can see what conditions might be like.

I made sure I knew the whereabouts of everyone in my family, and then I opened the door and stepped partially out onto the stoop.

He greeted me with a warm smile, “Hi, I’m _______, and I’m running for _______”

I’m dropping the name and the exact local office he’s running for to protect the innocent… or guilty, as the case may be.

He offered me a flyer or brochure, I’m not sure which, because I wasn’t looking at it. My eyes were 100% on him… still trying to accurately assess the situation.

I cut him off mid-sentence. “Did you see the ‘No Soliciting’ sign at the entrance of the neighborhood?”

“Oh no… I didn’t notice that,” he said, almost sheepishly.

Maybe he did… maybe he didn’t. I’m not sure.

I proceeded to let him know that the sign is legally posted at the entrance to the subdivision and that we have it there for a reason.

The rest of the conversation was pretty brief. I don’t think I was rude to him, although I might’ve been. I certainly didn’t take the flyer he was offering.

Good Hustle, My Friend

Look… I appreciate the challenges that candidates for local office face. It’s hard to get the word out about your candidacy, your beliefs, your strengths, and all the other reasons why you believe you should be elected.

And I’ve gotta tell you, I truly respect the effort and the chutzpah that it takes to go door to door and introduce yourself to voters.

I’ve done plenty of cold-calling in my life… for business, for charitable work, for… you name it—face to face, on the phone, and even online.

Any time you approach an unwilling subject and interrupt their life, you know you’re going to get every kind of reaction known to mankind. And most of them will reject you. My hat is off to anyone who knowingly faces that and goes for it anyway.

Seriously… respect, my friend.

Were I in some sort of advisory role for a candidate like him (which I am not, for the record… not at the moment, at least), I might even suggest that door-to-door solicitation would be a smart move. It puts you in front of the voters, lets them see your face, look you in the eye, shake your hand, and hear from you—straight from the horse’s mouth—why you’re running and what you have to offer.

I mean… even if the voters don’t agree with your positions, you will benefit from a simple human dynamic that we know makes a difference on election day: people vote for candidates with which they are familiar.

This guy was a nice enough guy… at least as much as I could gather from the 20-second conversation we had as I eyed him warily on my front porch.

And he was smart enough to walk straight down my driveway, get into his vehicle (yes, I noted the make, model & color—not that I really needed to… after all, he introduced himself by name), and drive right out of the neighborhood.

I looked him up after he left. He’s a family man. He’s got to understand the difficulties faced by someone like me who wonders exactly who it is that has marched right up to my front door.

But all of those factors that are in his favor can’t overcome one simple fact: any subdivision with a “No Soliciting” sign is off limits.

The sign serves as legal notice, so any law enforcement officer (or judge, if it got that far) would not accept the “I didn’t notice it” excuse.

If you’re going door-to-door, it is incumbent upon you to know whether you’re legally allowed to solicit in that neighborhood or not.

“Well I’m Not Selling Anything”

Fair enough. There are specific Florida statutes (501.022, for example), that regulate the behavior of commercial solicitors.

I’m not an attorney, and I haven’t researched any case law where political candidates are concerned. So… I could be wrong about the specific legality of the actions of my unnamed new friend.

However, there are also Florida statutes (102.031, for example) that regulate the behavior of people involved in conducting elections, and that particular subchapter specifically uses the term “solicit” to refer to the action of “soliciting” votes (although it specifically deals with actions that occur at polling places).

So… our “No Soliciting” sign could clearly be construed to apply to people soliciting votes. We don’t, after all, specify the type & nature of the solicitation.

Regardless of whether or not a Court would find that a political candidate soliciting votes had violated the law by ignoring a “No Soliciting” sign, the voters themselves might find it pretty easy to believe that the candidate had broken the law.

And after all… do you want to vote for someone who ignores the law (or at the very least, your stated wishes) in the very act of soliciting your vote?

I don’t think so.

For the record: I may or not find myself casting a vote for this guy on election day. It remains to be seen. I haven’t evaluated him nor his opponent(s), as of yet.

As for the matter of him coming to my door? I’m going to withhold judgment on that particular issue as I’m inclined to give him the benefit of the doubt over whether he actually saw the sign or not. For now. Especially since he did the right thing and immediately left the neighborhood after we spoke.

But if you’re a candidate for office, you would certainly do well to notice the signs at the entrance of any subdivision you enter. Others might not be so kind.

Photo: Marcus Quigmire via Flickr (CC BY 2.0)

Author Craig Richardson on Triangulation

Recently, I wrote about the book, Learn to Program With Minecraft, and shared my experience getting set up to use the book with Ubuntu instead of with Windows or Mac OSX.

Yesterday I learned that the author of that book, Craig Richardson, appeared on this week’s episode of Triangulation with Leo Laporte. It’s a fun episode… they set up Leo’s Mac to run a local Minecraft server, and test out a bunch of fun stuff from the book. Well worth the watch!

Learn to Program With Minecraft on Ubuntu

Update 3/20/2016: Thanks to one of our readers, Fabrizio Fazzino, for pointing out that a software update since these instructions were prepared makes it necessary to modify them. Specifically, we’re changing how the Spigot Server component gets installed & used. I’ve updated the instructions below accordingly.

Also, he’s prepared a more succinct set of instructions that summarizes the steps. If you’re not interested in learning as much about how and why this works,  I’d recommend you check my “Quick Note About Folder Structure” (in the yellow box below) and then follow his instructions.

Learn to Program With MinecraftRecently, I picked up a copy of Learn to Program with Minecraft®: Transform Your World with the Power of Python for my daughter and I to have a fun project to work on together.

Python is a programming language that I’ve long wanted to get acquainted with, and since she loves Minecraft so much, I felt like this book would be an ideal way for my daughter to also gain some exposure to it.

The only problem? We each use the Ubuntu distribution of Linux instead of Windows or Mac OSX.

You wouldn’t think this would be a problem: Minecraft is built in Java, which runs without a problem on Ubuntu (and many other platforms). Python is readily available for Ubuntu. Seems like a no-brainer, right?

Well… not quite. After the Amazon box arrived, I spotted this note on the back cover of the book:

The code in this book will run on Windows 7 or later, OS X 10.10 or later, or the Raspberry Pi. (See the last page for detailed requirements.)

No problem! The Raspberry Pi runs a special distribution of Linux called “Raspbian,” which is a version of Debian Linux, which is the upstream version of Linux that Ubuntu is based on. In other words: Raspbian & Ubuntu are cousins.

It seems reasonable, then, that if you can get this stuff working on the Raspberry Pi, then a much more powerful laptop running Ubuntu should be great!

Even more encouraging, there’s a nifty footnote at the bottom of Page 1 of the Learn to Program With Minecraft book which reads:

For information on other platforms and updates to these instructions, visit https://www.nostarch.com/pythonwithminecraft

Since the book had already been out for a few weeks, this note gave me hope that perhaps some instructions for setting up all the tools on Ubuntu might’ve already been added. Unfortunately, this is not the case (yet, anyway).

So… I decided to try to do it anyway. Since author Craig Richardson and the No Starch Press team had prepared download packages for the Mac & Windows platforms, I figured that at the very worst, there would be some clues in those packages that might help me get going.

Getting Minecraft & Python Set Up On Ubuntu

First, here is a simple set of requirements (as I understand them) for you to be able to use the instructions in the Learn to Program With Minecraft book on Ubuntu:

  • Minecraft – this is the game itself. If you don’t already have a license for the game, you’ll need to pick one up and install it. “Installing” Minecraft for Ubuntu is quite easy: simply download the .jar file from your Mojang account and launch it. We had done this long ago, so this step was already completed for us.
  • Python – This is the programming language you’re learning. More on finding & installing it in a moment.
  • Java – while you probably have a basic interpreter (the “runtime environment”) for Java already, you’ll need the Java Development Kit to run this next tool..
  • Spigot Server – This is Minecraft “server” software, which you can run on the same computer that Minecraft will run on. You need this because the Python connection to Minecraft relies on a server plugin that you can’t just run with your plain old Minecraft installation.
  • Minecraft Python API (py3minepi) – It turns out that this connection between Python and Minecraft was originally developed especially for the Raspberry Pi. The way I understand it, this tool is an API for Minecraft that works with Python. You need it.
  • Raspberry Juice Some brave souls created Raspberry Juice as a way to run the Python/Minecraft connection on other platforms (not just the Raspberry Pi).  When you follow the instructions in the book for Windows or Mac, this little gem is bundled in. But if you’re installing from scratch for Ubuntu, you’ll need to get it yourself. Not realizing this, I installed all the other tools and ran into a really nasty error that I couldn’t get around:

This error message was the part of the installation that was trickiest to resolve, but after a bit of digging, I was able to work it out.

The detailed instructions for each of these items follows (below). The one note I’d like to insert here is this:

I’m using Ubuntu 14.04 LTS, so your installation steps may vary somewhat if you’re using a different Ubuntu version.

Installing Python 3

You actually need 3 separate items that fall under the Python 3 heading:

  • Python 3 (the programming language itself)
  • IDLE (the development environment for Python, a/k/a the place where you’ll type commands and write programs)
  • PIP (the “package manager” for Python). You need this to install

For packages that are developed for Ubuntu, I tend to prefer using the “Ubuntu Software Center” to install stuff like this.

The only “gotcha” with Python is that there are a number of software versions and tools and so forth. So… launch the Software Center and search “python3” (with no space).

You should see a listing that says something like, “Interactive high-level object-oriented language (default python3 version)”

That’s the one you want. Do yourself a favor and click on “more info” so you can check the box for “IDLE 3” while you’re at it.

Install those, then run a similar search for “python3-pip” so you can use the package manager.

Prefer the command line to the Software Center?

Here are the commands to get python installed if you’d rather do this than use the Software Center. You’ll need to open a terminal to run these:

sudo apt-get install python3
sudo apt-get install idle3
sudo apt-get install python3-pip

You’re set with Python!

Installing Java 7

With Ubuntu, as is often the case, you have options here. You definitely need the Java SE SDK version 7 (presumably something newer would work as well) for the Spigot server to run.

Details on your options for Java on Ubuntu are here.

I used openjdk-7.

From the Ubuntu Software Center, just search “openjdk-7” and look for the “headless” option (this is lighter weight because it doesn’t include a GUI).

Or from the terminal:

sudo apt-get install openjdk-7-jre-headless

Installing Spigot Server

Update 3/20/2016 As I mentioned in the update at the top of this post, Spigot Server has released a new version: 1.9. Since the other components we’re using have not yet (as of today) updated to accommodate this, you’ll need to make sure that you download Spigot 1.8.8 and use it even though it is not the most recent version available.

Spigot is one of the most popular Minecraft server options, and is a necessary component in order to get Python & Minecraft talking to each other.

Getting the server software up & running is a matter of compiling the latest version. This reference page from the Spigot wiki is the one I used, and it seems to stay up to date. However, since it contains the instructions for multiple platforms, I’ll endeavor to simplify here.

One item to install first that will make this simpler is git. You’re going to need a terminal window anyway, so I’d recommend going ahead and opening it now and running this command to install git:

sudo apt-get install git

Next, you’ll want to download the Spigot BuildTools from this location:
https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar

A Quick Note About Folder Structure

To help make things easier on yourself, you might find it useful to use a somewhat similar folder structure to the one described in Learn to Program with Minecraft for the Windows & Mac users.

To accomplish this for myself, I opened the “Files” application and browsed to my “Documents” folder, then created a new folder called “MinecraftPython”, then inside that folder another called “MinecraftTools”.

I recommend moving the BuildTools.jar file that you just downloaded into that “MinecraftTools” folder.

To do this, you have a few options:

  • You can drag and drop using 2 “Files” windows, or
  • you can cut & paste if you just have one of those windows open.
  • Otherwise, you can move the file from the command line in a Terminal window with something like: mv ./Downloads/BuildTools.jar ./Documents/MinecraftPython/MinecraftTools/BuildTools.jar. Of course, you’ll need to modify that command to suit your particular situation (if you’re using a different folder structure or starting from a different location in your Terminal window than I did, for example).

Once that’s done, from your Terminal window, you’ll need to change directories to the location of your BuildTools.jar file. Depending upon where you’re starting from, that might mean a command that looks something like: cd ./Documents/MinecraftPython/MinecraftTools.

Then you’ll want to execute these 2 commands:

git config --global --unset core.autocrlf

java -jar BuildTools.jar This needs to be tweaked to make sure you use version 1.8.8 of the Spigot Server component (for now).

java -jar BuildTools.jar --rev 1.8.8

This will get the Spigot Server built. In order to finish installing, creating a startup script will be helpful. You can create one with gedit by running a command like this:

gedit start.sh

The gedit text editor will open. Copy and paste this into the editor:

#!/bin/sh

java -Xms512M -Xmx1024M -XX:MaxPermSize=128M -jar spigot-1.8.8.jar

Note: the filename “spigot-1.8.8.jar” was the current filename as of this writing. You’ll need to confirm that filename based upon your build, and edit the command here if it’s different use that filename as is for now (until the other components are updated to accommodate newer versions of Spigot server). Also, the Spigot instructions specifically note that the ‘MaxPermSize’ directive is no longer needed or supported in Java 8, but since I’m using Java 7, I left it in mine.

Save the file and close gedit.

Next, you’ll need to make the script executable. From the same terminal window, type:

chmod +x start.sh

Before you launch this file, you’ll need to accept the End User License Agreement. Locate the eula.txt file in your “MinecraftTools” folder and open it for editing. You can do this from a terminal window by typing gedit eula.txt . From the “Files” application, you can right-click the eula.txt file and choose the option to edit it with gedit.

Before you change the line that reads eula=false to eula=true, you’ll want to review the Minecraft End User License Agreement and verify that you’re ready to agree to its terms. Once you are, changing the value to “true” and saving the file will allow you to launch the Spigot Server without a hiccup (assuming that it is installed correctly).

Starting Your Spigot Server

Once that’s completed, you can start the Spigot Server to ensure it’s working properly. You’ll use this same command start the server each time you need to use it:

./start.sh

If all has gone according to plan, you should see the output of the server startup process in your terminal window. The Spigot Server will create a new Minecraft world as it launches, and once it’s up and running, you’ll see a > prompt with a flashing cursor next to it. You need to keep this window open.

Testing Your Spigot Server Installation

To test your server, launch Minecraft as usual.

Click “Multiplayer” and then choose “Add Server”

Give your new local server a name. The book recommends Minecraft Python World for it. In the “Address” box, type localhost. There’s a picture at the top of page 17 of the book which you can refer to as an example.

Quick note: if you’re using a typical Minecraft installation, then your Minecraft version will have updated by now to a version newer than the Spigot Server version. If so, you’ll need to edit your “Profile” and specify the Minecraft version to run so that it matches your Spigot Server version (1.8.8 if you’re following this writing exactly). Alternatively, you can create a new profile instead (this is what I chose to do) so that your main Minecraft profile continues to use the latest Minecraft version.

You can double-click the Minecraft Python World and check out your new world.

Note: The author’s downloads for Mac & Windows operating systems are pre-configured to be in Creative Mode. This world will be in Survival Mode instead. This can be changed by editing the server.properties file in your “MinecraftTools” folder and changing the line that reads gamemode=0 to gamemode=1 . You may also find that you need to change the line that reads force-gamemode=false to force-gamemode=true .

Play as long as you like, but before proceeding: you’ll want to stop the Spigot Server. In the window with the flashing cursor, simply type stop at the > prompt, and the Spigot Server will save everything and shut itself down.

Installing the Minecraft Python API

Next, you’ll need the Minecraft Python API. There’s a Github repository here:

https://github.com/py3minepi/py3minepi

I recommend just hitting the “Download Zip” button there. The file will be saved to your “Downloads” folder. You’ll want to extract the .zip file’s contents. You’ll end up with a folder called py3minepi-master, which we need to copy into the “Documents/MinecraftPython/MinecraftTools/” folder.

Once the folder has been relocated to the “MinecraftTools” folder, we need to run a command to install it. From your terminal window (assuming your current directory is still the “MinecraftTools” folder), type:

sudo pip3 install ./py3minepi-master

Installing Raspberry Juice

The last piece, I believe, is the actual Raspberry Juice plugin for Spigot. You can find it on the project’s home page:

http://dev.bukkit.org/bukkit-plugins/raspberryjuice/

Look for the “Recent Files” link on the right. As of this writing, the latest was RaspberryJuice v1.7 for 1.8.1. Follow the links, and eventually, you’ll end up with a .jar file.

This file needs to be copied into the “plugins” folder of your Spigot Server installation. If you’re following the directions here specifically, then you’ll find that folder at “/Documents/MinecraftPython/MinecraftTools/plugins”

Put the .jar file in that folder. Your Spigot Server will automatically find it the next time it starts up.

Time to Test!

If all has gone well, you should be ready for the “Getting to Know IDLE” section of the setup instructions on Page 20 of the book. If you’re able to successfully run the tests there, you’ve got everything set up correctly!

It was at this stage that I got that nasty error I mentioned earlier:

ConnectionRefusedError: [Errno 111] Connection refused

after typing this command into IDLE:

mc = Minecraft.create()

When I got the “connection refused” error, I did a bunch of searching, but nothing seemed to fit. Ultimately, I hunted down the port number that the “minecraft.py” script was trying to connect to (port 4711). This didn’t make any sense, because the Minecraft server software defaults to port 25565. Searching around for information about what might be running (or not running, in my case) on port 4711 was what yielded the information about the Minecraft Python API.

Thankfully, author Craig Richardson left some clues for us in the pre-packaged downloads he made available for Windows & OSX. On my Ubuntu system, I opened up the download he prepared for OSX (since OSX and Linux are more or less cousins, I figured it would be worth a shot) and found Raspberry Juice. It was perhaps the least obvious component of this whole setup.

So far, this setup has been working for me. I’m not 100% certain that I haven’t missed something, but if I have, then it doesn’t appear to be affecting things so far.

I hope you find this helpful! Let me know what you run into in the comments. I’ll do my best to help!