2017 © Pedro Peláez
 

library minecraft

A fluent wrapper around Minecraft's API.

image

juggl/minecraft

A fluent wrapper around Minecraft's API.

  • Monday, January 11, 2016
  • by svenluijten
  • Repository
  • 1 Watchers
  • 3 Stars
  • 69 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 2 Versions
  • 0 % Grown

The README.md

THIS VERSION IS DEPRECATED! PLEASE USE sven/minecraft-php INSTEAD., (*1)

Minecraft API

Latest Version on Packagist Total Downloads ![Software License][ico-license], (*2)

This is a simple package providing you with all the tools to quickstart development on that Minecraft site you've been craving. Retrieve UUIDs based on usernames or the other way around with a simple and human-readable API., (*3)

Install

Via composer:, (*4)

$ composer require juggl/minecraft

If you're using the Laravel framework, you can add the MinecraftServiceProvider to your providers array:, (*5)

// config/app.php
'providers' => [
    ...
    Juggl\Minecraft\MinecraftServiceProvider::class,
    ...
];

You may also add the Minecraft facade to the aliases array to use the facade:, (*6)

// config/app.php
'aliases' => [
    ...
    'Minecraft' => Juggl\Minecraft\Facades\Minecraft::class,
    ...
];

Usage

$minecraft = new Juggl\Minecraft\Minecraft;

// Retrieve UUID (without dashes) based on the username provided.
$minecraft->getUuidFromName($username);

// Supply an optional UNIX timestamp to get the UUID of the user who owned that
// username at the time.
$minecraft->getUuidFromName($username, time() - (365 * 24 * 60 * 60));

// Get array of names the user has played as.
$minecraft->getNameHistory($uuid);

// Extract current username from UUID provided.
$minecraft->getNameFromUuid($uuid);

// Get array of objects with info about each user (username & UUID).
$minecraft->getUuidsFromNames(['Notch', 'jeb_', 'Dinnerbone']);

If you specified the alias in config/app.php, you can use the facade:, (*7)

Minecraft::getUuidFromName($username);

Of course, all other methods can also be accessed this way., (*8)

Rate limiting

Mojang has some rate limiting in place so you are expected to cache the results. For everything in this package, the limit is 600 requests every 10 minutes. Keep in mind Mojang might change this at any time., (*9)

Credits

This is simply a wrapper around Mojang's API, beautifully (yet unofficially) documented at http://wiki.vg/Mojang_API., (*10)

License

Juggl\Minecraft is licenced under the MIT License (MIT). Please see the license file for more information., (*11)

The Versions

11/01 2016

dev-master

9999999-dev https://github.com/Jugglio/Minecraft

A fluent wrapper around Minecraft's API.

  Sources   Download

MIT

The Requires

 

by Sven Luijten

api minecraft mojang

03/10 2015

1.0.0

1.0.0.0 https://github.com/svenluijten/Minecraft

Laravel wrapper for Mojang's Minecraft API

  Sources   Download

MIT

The Requires

 

The Development Requires

by Sven Luijten

api minecraft mojang