• Stars
    star
    360
  • Rank 118,230 (Top 3 %)
  • Language
    Java
  • License
    MIT License
  • Created over 9 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The SpongeAPI implementation targeting vanilla Minecraft and 3rd party platforms.

Sponge Java CI with Gradle

The SpongeAPI implementation targeting vanilla Minecraft and 3rd party platforms. It is licensed under the MIT License.

Latest Builds

Sponge

Sponge Latest

Sponge 1.16.5

SpongeVanilla

SpongeVanilla Latest

SpongeVanilla 1.16.5

Prerequisites

Clone

The following steps will ensure your project is cloned properly.

  1. git clone --recursive https://github.com/SpongePowered/Sponge.git
  2. cd Sponge
  3. cp scripts/pre-commit .git/hooks

Setup

Note: Sponge uses Gradle as its build system. The repo includes the Gradle wrapper that will automatically download the correct Gradle version. Local installations of Gradle may work (as long as they are using Gradle 6.8+) but are untested. To execute the Gradle wrapper, run the ./gradlew script on Unix systems or only gradlew on Windows systems.

To have browsable sources for use in-IDE, run ./gradlew :decompile. This command will need to be re-ran after any change to Minecraft version or to .accesswidener files. If sources are not appearing properly, an IDE refresh should fix things.

IDE Setup

For Eclipse

  1. Make sure the Buildship plugin is installed (available on the Eclipse Marketplace)
  2. Import the project as an Existing Gradle Project (via File > Import > Gradle)

While we do our best to support any IDE, most of our developers use IntelliJ, so issues may pop up with Eclipse from time to time. We'll be happy to work to resolve those issues if reported via our issues page or fixed via PR.

For IntelliJ

  1. Make sure you have the Gradle plugin enabled (File > Settings > Plugins).
  2. Click File > New > Project from Existing Sources > Gradle and select the root folder for Sponge.
  3. Make sure Use default gradle wrapper is selected. Older/newer Gradle versions may work but we only test using the wrapper.

For both Eclipse and IntelliJ, a variety of run configurations will be generated which allow running the client and server in development. These run configurations will be re-generated on each project import, so any desired modifications should be done on copies of the configurations.

While these run configurations have Java versions attached to them, be aware that IntelliJ ignores that information entirely, and Eclipse will only be able to align those java versions with whatever JREs it is aware of.

Building

In order to build Sponge you simply need to run the gradlew build command. On Windows systems you should run gradlew build instead of ./gradlew build to invoke the Gradle wrapper. You can find the compiled JAR files in ./build/libs and ./vanilla/build/libs.

Updating your Clone

The following steps will update your clone with the official repo.

  1. git pull
  2. git submodule update --recursive
  3. ./gradlew build --refresh-dependencies

Contributing

Are you a talented programmer looking to contribute some code? We'd love the help!

  • Open a pull request with your changes, following our guidelines.
  • Please follow the above guidelines for your pull request(s) to be accepted.

More Repositories

1

Mixin

Mixin is a trait/mixin and bytecode weaving framework for Java using ASM
Java
1,229
star
2

SpongeForge

A Forge mod that implements SpongeAPI
Java
1,150
star
3

SpongeAPI

A Minecraft plugin API
Java
1,127
star
4

Configurate

A simple configuration library for Java applications providing a node structure, a variety of formats, and tools for transformation
Java
310
star
5

SpongeVanilla

The SpongeAPI implementation for Vanilla Minecraft.
Java
255
star
6

SpongeDocs

Documentation for Sponge and its Implementations
Java
103
star
7

noise

Noise generation library for Java, based on the libnoise C++ library. It is used to generate coherent noise, a type of smoothly-changing noise. It can also generate Perlin noise, ridged multifractal noise, and other types of coherent noise.
Java
101
star
8

MixinGradle

Gradle plugin that adds the Mixin technology capability to your project.
Groovy
90
star
9

VanillaGradle

A toolchain for Minecraft: Java Edition that builds a workspace to interact with the game using the official mappings provided to the public by Mojang Studios.
Java
90
star
10

Ore

Repository software for Sponge plugins and Forge mods
Scala
75
star
11

math

Immutable math library for Java that offers easy conversion between math types, fast trigonometric functions, vectors, matrices, complex numbers, quaternions, and operation chaining, with a focus on games and computer graphics.
Java
54
star
12

nbt

Named Binary Tag (NBT) library for Java based on Graham Edgecombe's JNBT library. NBT is a tag based binary format designed to carry large amounts of binary data with smaller amounts of additional data.
Java
50
star
13

McTester

An integration testing framework for Minecraft
Java
39
star
14

Schematic-Specification

Schematic Format Specification for Minecraft
36
star
15

Cookbook

SpongeAPI munchy crunchy delicious recipes
Java
35
star
16

SpongeGradle

Handy gradle utilities for the various gradle projects of SpongePowered
Java
21
star
17

SpongeHome

A brand new homepage for SpongePowered
SCSS
15
star
18

SpongeAuth

An authentication portal for shared user accounts between Sponge services.
Python
10
star
19

sponge-docs-theme

Theme for the sponge documentation
JavaScript
8
star
20

LaunchWrapperTestSuite

A LaunchWrapper JUnit Test Suite
Java
7
star
21

OrePlugin

Package manager for the Sponge platform using the Ore web service.
Java
7
star
22

Spongie

The one and only hard working bot for Sponge!
Java
6
star
23

plugin-meta

Plugin Metadata Specification
Java
6
star
24

SystemOfADownload

Downloads webpage builder, backend builds the database and pages
Java
5
star
25

event-impl-gen

Used for generating SpongeEventFactory in SpongeAPI
Java
5
star
26

DownloadIndexer

The download indexer and API for the Sponge project
Go
4
star
27

LegacySpongeAuth

An authentication portal for shared user accounts between Sponge services.
Scala
4
star
28

sponge-plugin-template

A template for making a Sponge plugin for SpongeAPI 8.0.0
Java
3
star
29

sponge-plugin-archetype

Java
3
star
30

SpongeWebGo

Go
2
star
31

Metronome

Hax?
Java
2
star
32

APIJavadocs

HTML
2
star
33

Royale

Anaheim, CA - Minecon 2016 Exhibition showcase. Battle royale.
Java
2
star
34

collections

Uncommon data structure collections for Java 8
Java
2
star
35

gitpatcher

Groovy
2
star
36

repoindexer

Java
2
star
37

observer

Java
1
star
38

SpongeDownloads

The downloads page for the Sponge project
Vue
1
star
39

Lorenz

Java
1
star
40

plugin-spi

Plugin Loading Specification
Java
1
star