Git Product home page Git Product logo

ilblu's Introduction

Ilblu

GitHub-CI Workflow Status CodeMC-CI Build Status Paper Behind By

Ilblu is a fork of the Minecraft Server Software Paper, it should support all Spigot plugins. This project uses combined changes and small improvements from:

Projects whose patches were copied are marked with an Asterisk

The main goal of this project is creating a better framework for forks of paper and in turn also their forks

TODO

  • Actions/Workflow Integration
  • Improve README for newer users
  • Switch from Maven to Gradle (1/2)
    • Get rid of ugly build.gradle hack (2/2)
    • Create gradle task chain
    • Only include important imports (1/2)
  • Further improve scripts
    • Make scripts space safe
    • Rewrite all scripts
    • Make more paper like (2/2)
    • Test mc-dev imports
    • Test library imports
  • Actually make changes to the game
  • Centralise constants (1/2)
    • Resource Token replacement
    • Source code Token replacement
    • Reenable repositories and pushes
  • Make as easily forkable as possible
    • Multi forking support

Get Ilblu

Download

Plugin API

[WIP]

Maven

<repository>
    <id>codemc-snapshots</id>
    <url>https://repo.codemc.io/repository/maven-snapshots/</url>
</repository>

<dependency>
    <groupId>io.github.paul1365972</groupId>
    <artifactId>ilblu-api</artifactId>
    <version>1.15.2-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

Gradle

repositories {
    maven {
        url "https://repo.codemc.io/repository/maven-snapshots/"
    }
}

dependencies {
    compileOnly "io.github.paul1365972:ilblu-api:1.15.2-R0.1-SNAPSHOT"
}

This also includes the Paper-, Spigot- and Bukkit-API

Build

Requirements

  • Java (JDK) 8 or above
  • Maven
  • Git, with a configured user name and email. On windows you need to run from git bash.

Compile

If all you want is a paperclip server jar, just run:

./ilblu jar init

alternatively you can also use ./gradlew paperInit paperPaperclip

Developing

To get started clone this repository and run ./ilblu patch init or ./gradlew paperInit paperApplyPatches to setup your workspace.

Creating patches

  • Make changes to Ilblu-API or Ilblu-Server and commit them
  • Run ./ilblu rebuild or ./gradlew paperRebuildPatches to create the patch files
  • Finish by committing and pushing the changes made to the patch files

Testing

Important: Test jars contain copyrighted material and should be distributed under no circumstances

You have two options for building your test server jar

Gradle (recommended): Run ./gradlew shadowJar, output in Ilblu-Server/build/libs

Bash: Run ./ilblu build (or ./gradlew paperBuild), output in Ilblu-Server/target

Deploying

To get a distributable server jar (paperclip) you again have two options

Gradle (recommended): Run ./gradlew paperclip

Bash: Run ./ilblu jar (or ./gradlew paperPaperclip)

Important for Bash: Commit any changes and rebuild your patches before deploying or they will be lost forever

Still confused?

Creating and editing patches is explained in great detail over at PaperMC.

Side note: Rebasing will be one of your best friends when creating patches, be sure to understand it well.

LICENSE

See LICENSE

Everything in this repository is free to be used in your own fork, except when noted otherwise.

See list above for the license of material used/modified by this project.

By using this project you accept the Mojang EULA! Using this project requires that you have read and accepted the EULA because of this patch!

ilblu's People

Contributors

paul1365972 avatar

Watchers

James Cloos 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.