For some time, some coworkers and I have wondered if it would be possible to get Minecraft talking to Azure. The recent news about Microsoft and Minecraft gave us some extra incentive to try out out… so we decided to build a companion mobile app using Azure Mobile Services. The app sends me a push notification if someone enters my house in Minecraft and also lets me check what items I have in my in-game inventory. 

The basic design is as follows:

1. Certain objects in Minecraft are connected to computers in the game. This includes things like a pressure plate and a chest.
2. The computers send HTTP requests to a mobile service, passing in some simple payloads. This is implemented via some simple programs running on the computers.
3. The mobile service can store data in a table or send a push notification
4. The mobile app is connected to the service to pull table data and receive notifications.

Setting up the mobile service

First, we need to set up endpoints in the cloud for Minecraft to send information to. This is needed because the app can’t talk directly to the game.

1. Create a Node.js-based mobile service in the Azure Management portal.
2. On the API tab, create a new custom API called notifyallusers, using the code available here. This API simply takes any message passed in the body of the HTTP POST and sends it as a push notification to all subscribed devices.
3. Create another API called updateinventory, using the code from here. This API takes any key=value pairs in the body of the HTTP POST and tries to insert them into an Inventory table.
4. We need to create the Inventory table, so head over to the DATA tab and create it. You can leave the permissions as is.
5. Head over to the PUSH tab and complete sections 1 and 2 of this tutorial to get your service set up to send push notifications. Don’t worry about the server or client code, just do the configuration steps in the portal.

Now your mobile service is now all set up to receive requests. Let’s now go into Minecraft and configure it to send requests. 

Minecraft setup

Before we even launch the game, we need to make sure we have the right mod installed, since programmable computers are not part of the game by default. In this example, we used ComputerCraft, which, lets you write simple Lua scripts and run them in the computer.

Once you have the mod running, you need to do the following:

1. To monitor the contents of a chest, put a Trapped Chest directly adjacent to a Computer (in my case it was right on top).
2. To set up the push notification when someone enters a house, place a Pressure Plate right behind the door. Then put a Computer somewhere nearby. Connect the two by putting down Redstone to connect the two. 
3. We now need to load the right programs into the two computers. The computer attached to the pressure plate will use the script AlertIntruder and the other one will use the script PostInventory. Be sure to change the URLs in the scripts to point to your own mobile service.
4. Typing the script in is quite cumbersome, so it’s easier to use Pastebin as an intermediary. Create a paste with the code and get the ID of the paste.
5. In the computer, type pastebin get ID scriptName.
6. Now that the script is downloaded locally, you can run it easily by typing it in (with the above example, just type scriptName). If you need to stop the program, hold down Ctrl + T.
7. Make sure both scripts are downloaded and running on both computers.

When done it will look something like this:

Run the app

Now that the mobile service is set up and Minecraft is ready to send requests, the last part is to get our app set up and connected to the mobile service. 

1. Get the source for the app from here and open it in Android Studio.
2. Download the right libraries from here and drop them in the lib folder. You’ll need to grab both mobileservices-2.0.1-beta.jar as well as notifications-1.0.1.jar, the other dependencies should get brought down by Gradle when you build your project in Android Studio.
3. The last step is to configure the connection information for your mobile service. Copy the file Secrets.java.example and rename it to Secrets.java. You will then need to copy your mobile service URI and app key from the Azure portal and paste them into that file. You will also need your project ID from the Google APIs Console.

You should now be good to go! Stepping on the pressure plate should cause a push notification to fire off on the phone. Opening and closing the chest should trigger an update to be sent to the service. Add or remove items and then use the Refresh button in the app to see the content update.

This quick example is just the start of what you can do with the awesome capabilities provided by Azure Mobile Service. Excited to see what other cool Minecraft hacks you’ll put together using these tools!

Read More

Thanks to all who joined me for the Droidcon NYC 2014 keynote on Sunday morning. I’ll share the code and video recording as soon as it’s available, for now here are the slides.

A walkthrough of the Minecraft demo and how to build it is now available here.

Read More

Update: look at that… based on your feedback we’ve baked this right into the product (starting with version 1.0.342 of our NuGet package). Check out this tutorial for instructions on how to use the new initializers, and please disregard the code below. What’s in the box works better!

A few folks have encountered an issue while developing a .NET-based mobile service using our VS template or portal quickstart. If you publish your mobile service to the cloud and then make some changes to the model and re-publish, the EF initializer will fail complaining that it doesn’t have sufficient permissions. The error might look like so in the Logs tab of the portal:

Exception=System.InvalidOperationException: This operation requires a connection to the 'master' database. Unable to create a connection to the 'master' database because the original database connection has been opened and credentials have been removed from the connection string. Supply an unopened connection. ---> System.Data.SqlClient.SqlException: Login failed for user 'zXCBHhDWhTLogin'.

This is the case because by default we use the DropCreateDatabaseIfModelChanges initializer, but the user under which your mobile service accesses your Azure SQL database doesn’t have the permission to drop the database.

To work around that we have developed an alternative initializer that does largely the same thing, but works using the permission set we already have. Please exercise caution: this initializer will delete your data. It is intended to be used during development while you are experimenting with your model and database schema.

Here is the example: instead of dropping the whole database, it just drops the tables used by your mobile service:

~~~ csharp public class DropCreateSchemaTablesIfModelChanges : CreateDatabaseIfNotExists where TContext : DbContext { private string schemaName;

Read More

The new support for writing mobile services in .NET has made it even easier for developers writing Windows Phone 8.1 apps to add a cloud hosted backend. Check out this short video to learn more.

Read More

UPDATE: The below content is now outdated… we have enabled a first-class connection string picker on the Configure tab of your mobile service. Specify the connection string there, and then you can easily use it exactly the same way as if it were defined in Web.config. 

Since we introduced the .NET backend in Mobile Services, with rich support for connecting to existing databases, we have received a lot of questions around using custom connection strings. By default, Mobile Services creates an Azure SQL Database for you and the connection string used to refer to that is named MS_TableConnectionString. Our quickstart and Visual Studio project template uses that connection string by default. 

So what do you do if you want to use your own connection string? It depends on what kind of database yo have.

• If your database is a Azure SQL database, just use the nifty Change Database button on the Configure tab of your mobile service. This will directly update the MS_TableConnectionString.
  
• If you are bringing your own database (for example SQL Server on IaaS), you cannot currently modify the MS_TableConnectionString connection string. We are working on enabling that and adding first-class support for connection string management right in the portal, but for now we have a simple workaround. Read on.

The first thing you need to do is find the App Settings section on the Configure tab of your mobile service. Create a new setting called for example onPremisesDatabase and set the value as your custom connection string.

Inside your app, find the DbContext that your .NET mobile service is using. Modify it as shown below. You might need to add an assembly reference to System.Configuration to your project.

public class customDatabase1Context : DbContext
{
    public customDatabase1Context()
        : base(ConfigurationManager.AppSettings["onPremisesDatabase"])
    {
    }
}

Then simply publish your changes and your service will now use your custom connection string. You are welcome to go and update the app setting in the portal if you need to and you don’t need to re-publish your app for the change to take effect.

Hope this helps!

Read More

If you want to learn about the new option of writing a .NET backend for your Azure Mobile Service, check out this video I made with Nick and Chris. We cover using new or existing data models and also demonstrate how to remotely debug the live service.

Read More