Rivoreo Source Code Repositories
src.rivoreo.one / glowstone / 1d33bdf14d07466ece54c88a7474dced7c57768e
commit1d33bdf14d07466ece54c88a7474dced7c57768e[log] [download]
authordeathcap <deathcap@gmx.co.uk>Fri Apr 24 21:32:41 2015 -0700
committerdeathcap <deathcap@gmx.co.uk>Fri Apr 24 21:32:41 2015 -0700
tree443585bc622aba917a499b3ba3074a5585dfce40
parent080f3415c8f73f678fe681cbc6528972927762b8 [diff]
Change SpongeAPI plugin detection to use ASM instead of classloading

Since ASM analyzes the bytecode without loading it, it can check for the
@Plugin class annotation to detect SpongeAPI plugins, instead of using
classloader findClass which requires the exact SpongeAPI to be present.
3 files changed
tree: 443585bc622aba917a499b3ba3074a5585dfce40
  1. .gitattributes
  2. .gitignore
  3. .gitmodules
  4. .travis.yml
  5. CONTRIBUTING.md
  6. Glowkit
  7. LICENSE
  8. README.md
  9. circle.yml
  10. deprecation-mappings.at
  11. deprecation-mappings.csrg
  12. etc/
  13. mixins.txt
  14. pom.xml
  15. src/
README.md

Glowstone++

An experimental fork of Glowstone focused on additional compatibility

Build Status

(Warning: may be unstable, this is only an experiment, use at your own risk)

Currently the major changes from Glowstone include:

Building from source

  1. After installing the Java Development Kit and Maven, checkout the source:
git clone --recursive https://github.com/deathcap/GlowstonePlusPlus
cd GlowstonePlusPlus
  1. Build and install the APIs:
cd Glowkit
mvn install
cd ..
cd SpongeAPI
./gradlew
cd ..
  1. Build the server:
mvn package

The final jar will be placed in target/ named glowstone++-1.8.3-SNAPSHOT.jar.

Downloads

If you don't want to build from source, prebuilt jar files are available to download from:

  • CircleCI downloads - click the latest build then expand “Artifacts” (if it does not show, try logging in with GitHub) Build Status

Introduction

Glowstone is a lightweight, from scratch, open source Minecraft server written in Java that supports plugins written for the Bukkit API.

The main goals of the project are to provide a lightweight implementation of the Bukkit API and Minecraft server where exact vanilla functionality is not needed or higher performance is desired than the official software can deliver. Glowstone makes use of a thread-per-world model and performs synchronization only when necessitated by the Bukkit API.

Features

Glowstone has a few key advantages over CraftBukkit:

  • It is 100% open source. While CraftBukkit and most other mods are open source, they rely on decompiled Minecraft source code. Glowstone's code is completely original.
  • Because of this, it is easy to contribute to Glowstone's development. The barrier of entry to contributions is lower because there is no need to work around decompiled source or maintain a minimal diff.
  • Glowstone supports all plugins written for the Bukkit API natively. In practice, some plugins may try to make use of parts of the API which are not yet implemented, but in a completed state Glowstone would support all plugins.
  • Glowstone's simplicity affords it a performance improvement over CraftBukkit and other servers, making it especially suited for situations where a large amount of players must be supported but Vanilla game features are not needed.

However, there are several drawbacks:

  • Glowstone is not finished. Nothing is guaranteed to work, though many things are likely to. If in doubt, file an issue.
  • Vanilla survival features are entirely absent (mobs, hunger, health, so on). Glowstone cannot yet replicate a vanilla survival environment. These will be added over time.
  • Bukkit plugins which expect the presence of CraftBukkit-specific code (that in the org.bukkit.craftbukkit or net.minecraft.server packages) will not work on Glowstone unless they are designed to fail gracefully.
  • Glowstone is not produced by the Bukkit team, and while we do make an effort to produce quality work, Glowstone does not undergo the same rigorious testing as the Bukkit project.

Some of the key features that have been implemented are:

  • World loading, saving, and streaming to players.
  • Player interaction with the world (building, digging).
  • Somewhat-complete inventory support.
  • A sophisticated world generator (support for others through Bukkit).
  • World weather (rain, thunder/lightning).
  • Op, ban, IP ban, and whitelist support.
  • Many of the advanced API features of Bukkit.

Building and Running

Glowstone can be built with the Java Development Kit and Maven The command mvn package will build Glowstone and place the final jar in target/ named glowstone++-1.8.3-SNAPSHOT.jar.

Running Glowstone is simple because its dependencies are shaded into the output jar at compile time. Simply execute java -jar glowstone++.jar along with any extra JVM options desired. A variety of command-line options are also available - run java -jar glowstone++.jar --help for more information.

By default, configuration is stored in the config/ subdirectory and logs are stored in the logs/ subdirectory. The main configuration file is config/glowstone.yml, which replaces CraftBukkit‘s server.properties and bukkit.yml. Settings from these two files will be copied over to Glowstone’s configuration during the default configuration generation process.

Glowstone uses JLine for console input and colored console output. The JLine console can be disabled in the configuration if a flat console is desired.

Docs and Support

The best place to receive support is on GitHub issues. When reporting bugs, please retest and include whether the problem reproduces on:

Javadocs can be generated by using the mvn javadoc:javadoc command and are placed in the target/site/apidocs/ directory, but these are incomplete -in some places and in general the code is the best reference.

For documentation on the Glowkit API (an updated Bukkit which is used to write plugins), see the Glowkit Javadocs or visit Spigot's Bukkit Javadocs.

Credits

Copyright

Glowstone is open-source software released under the MIT license. Please see the LICENSE file for details.

Glowkit is open-source software released under the GPL license. Please see the LICENSE.txt file in the Glowkit repository for details.