GithubHelp home page GithubHelp logo

mourdraug / spout Goto Github PK

View Code? Open in Web Editor NEW

This project forked from spoutdev/spout

1.0 1.0 0.0 4.19 MB

An open-source implementation of the Minecraft server software written in Java, originally forked from the Glowstone project.

Home Page: spout.org

License: Other

spout's Introduction

Spout

Introduction

Spout is an open-source implementation of the Minecraft server software written in Java, originally forked from Tad Hardesty's Glowstone project, which was originally forked from Graham Edgecombe's now-defunct Lightstone project.

The official server software has some shortcomings such as the use of threaded, synchronous I/O along with high CPU and RAM usage. Spout aims to be a lightweight and high-performance alternative.

Spout's main aim as a project independent from Lightstone is to offer a higher-performance server while implementing the SpoutAPI platform for Minecraft mods.

Building

Spout can be built with the Java Development Kit and Apache Maven. Maven is also used for dependency management.

You may download and compile SpoutAPI yourself if you desire and install it using mvn install, but it and other dependencies will be automatically downloaded by Maven if they are not found.

The command mvn package will build Spout, and mvn install will copy it to your local Maven repository. Official builds of Spout may be found on Jenkins.

Running

Running Spout is simple because all dependencies, including SpoutAPI, are shaded into the output jar at compile time thanks to a nifty Maven plugin. Simply execute java -jar spout-dev-SNAPSHOT.jar along with whatever memory-related options to Java you desire, and the server should start.

By default, configuration is stored in the config/ subdirectory and logs are stored in the logs/ subdirectory. The main configuration file is config/spout.yml.

Spout uses a JLine-based server console for command input. On non-Windows systems, console output can also be colored.

Documentation

Javadocs can be generated by using the mvn javadoc:javadoc command in the terminal. This utilizes Maven's javadoc plugin and may need to download dependencies the first time it is run.

For documentation on the Spout API, see the SpoutAPI Javadocs.

Credits

  • The Minecraft Coalition - protocol and file formats research.
  • Trustin Lee - author of the Netty library.
  • Graham Edgecombe - author of the original Lightstone - and everyone else who has contributed to Lightstone.
  • All the people behind Maven and Java.
  • Notch and all the other people at Mojang - for making such an awesome game in the first place!

Copyright

Spout is open-source software released under the LGPLv3 license, but with a provision that files are released under the MIT license 180 days after they are published. Please see the LICENSE.txt file for details.

spout's People

Contributors

afforess avatar akrieger avatar bergerkiller avatar darsstar avatar ddos avatar grahamedgecombe avatar hef avatar katuma avatar md-5 avatar mikeprimm avatar narrowtux avatar raphfrk avatar sleaker avatar spacemaniac avatar stephenwilliams avatar tips48 avatar tomylobo avatar top-cat avatar victord avatar yetanotherx avatar zhuowei avatar zml2008 avatar

Stargazers

 avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.