dotstart/stockpile

Smart caching server for the Mojang API

Stockpile

Lightweight and protocol aware API proxy for the Mojang APIs.

Looking for Stockpile 1.0? Its source code may still be accessed here

Key Features

• Customizable (broad configuration options and plugin support)
• gRPC based (clients may be generated for most popular languages)
• Completely Open Source

Installation & Setup

1. Download a binary release from the releases page or build from source
2. Extract or copy the Stockpile executable and plugin directory (if applicable) to a custom directory (convention for Linux systems is /opt/stockpile)
3. Create a configuration file (for examples, refer to the docs directory in the source distribution)
4. Start Stockpile via ./stockpile server -config=path/to/myconfig.hcl

Note that you may additionally launch Stockpile in development mode via ./stockpile server -dev in order to automatically select a set of acceptable default parameters without requiring a customized configuration file.

Once the server is running, you may access its functionality via the stockpile executable. Run ./stockpile help for more information on the respective client commands. If configured you may also access the Web UI via <your ip or hostname>:36623 (or wherever you configured Stockpile to listen) assuming that it has been enabled (the Web UI is enabled by default in development mode).

Prerequisites

The following applications are required to be present within your system PATH when building the application from source (some may be omitted if you are willing to skip some of the build steps):

• git (latest recommended)
• go (1.10 or newer)
• protobuf (including protobuf go plugin)
• node & npm (latest recommended)

Building

1. go get -d -u github.com/dotStart/Stockpile/...
2. cd $(go env GOPATH)/src/github.com/dotStart/Stockpile
3. make

The resulting binaries will be located in the build directory.

Note: Binaries built on Windows will not provide support for plugins (nor will they include the standard plugins). If you wish to build a version for distribution (or execution in a production environment), please build them on Linux (for instance, using the Vagrant configuration included within this repository).

License

Copyright [year] [name] <[email]>
and other copyright owners as documented in the project's IP log.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

stockpile's Issues

Plugin API

Provide a plugin API in order to allow modification of output data or otherwise alter the cache lifecycle in order to provide more customization options for users with more specific needs.

Relevant elements to this issue are:

• Altering of profile data (on the fly and permanent)
• Adding of profile properties (on the fly and permanent)
• Implementation custom database backends
• Management of the cache lifecycle

Redis as NoSql database

Would it be possible to use NoSql database like redis?

Error 500 using mysql

<Map xmlns="">
<timestamp>1466086953711</timestamp>
<status>500</status>
<error>Internal Server Error</error>
<exception>
org.springframework.dao.InvalidDataAccessApiUsageException
</exception>
<message>
org.springframework.web.util.NestedServletException: Request processing failed; nested exception is org.springframework.dao.InvalidDataAccessApiUsageException: org.hibernate.TransientPropertyValueException: Not-null property references a transient value - transient instance must be saved before current operation : com.torchmind.stockpile.server.entity.DisplayName.profile -> com.torchmind.stockpile.server.entity.Profile; nested exception is java.lang.IllegalStateException: org.hibernate.TransientPropertyValueException: Not-null property references a transient value - transient instance must be saved before current operation : com.torchmind.stockpile.server.entity.DisplayName.profile -> com.torchmind.stockpile.server.entity.Profile
</message>
<path>/v1/name/sgdc3</path>
</Map>

Support for common caching and No-SQL backends

Along with the changes in #3, a set of new database backends should be added in order to simplify integration with more specific network setups.

Relevant implementations include:

• Mongo
• Redis
• Elastic Search (?)
• Cassandra (?)

What about skins?

Multiple instances with the same database.

In order to bypass the MojangApi request limit is it possible to use multiple instances of stockpile?
Thanks ;)