Skip to content

Latest commit

 

History

History
143 lines (111 loc) · 5.37 KB

README.md

File metadata and controls

143 lines (111 loc) · 5.37 KB
Raw

nukkit

License: GPL v3 PowerNukkit v1.X Discord

Introduction

Nukkit is nuclear-powered server software for Minecraft: Pocket Edition. It has a few key advantages over other server software:

  • Written in Java, Nukkit is faster and more stable.
  • Having a friendly structure, it's easy to contribute to Nukkit's development and rewrite plugins from other platforms into Nukkit plugins.

Nukkit is under improvement yet, we welcome contributions.

PowerNukkit is a modified version of Nukkit that adds support to a huge amount of features like water-logging, all new blocks, more plugin events, offhand slot, bug fixes and many more.

Please note that PowerNukkit is not handled by Cloudburst's staff and is provided with love but without warranty. If you find any issue while running PowerNukkit you should create a new issue in this repository first.

It's also advisable to have a backup schedule set up, use plugins that are made for PowerNukkit and use only stable PowerNukkit versions.

Most Cloudburst Nukkit plugins are supported but they may not understand the new blocks and items and the new stuff that you can do with PowerNukkit.

Links

Creating Plugins

Add PowerNukkit as dependency, it's hosted by maven central and jcenter, so you don't need to specify a custom repository.

Click here to see the full gradle example

repositories {
    mavenCentral()
}

dependencies {
    compile group: 'org.powernukkit', name: 'powernukkit', version: '1.3.2.0-PN-ALPHA.3'
}

Click here to see the full maven example

<dependencies>
    <dependency>
        <groupId>org.powernukkit</groupId>
        <artifactId>powernukkit</artifactId>
        <version>1.3.2.0-PN-ALPHA.3</version>
    </dependency>
</dependencies>

Build JAR file

  • git clone https://github.com/PowerNukkit/PowerNukkit
  • cd PowerNukkit
  • git submodule update --init
  • ./mvnw clean package

The compiled JAR can be found in the target/ directory.

Use the JAR that ends with -shaded to run your server.

Running

Simply run java -jar powernukkit-<version>-shaded.jar in an empty folder.

Docker

Running PowerNukkit in Docker:

Run these commands in terminal or cmd: (copy & paste everything at once may work)

mkdir my-server
cd my-server
curl -sSL https://raw.githubusercontent.com/PowerNukkit/PowerNukkit/master/docker-compose.yml > docker-compose.yml

If you want to keep your server always updated when it restarts, run with:
(edit the docker-compose.yml file to choose the base version you want)

docker-compose run --rm --name powernukkit server

But if you want to keep using the same version and update, use this command to create a fixed container

docker-compose run --name powernukkit server

To return to the terminal and keep the server running:
Keep holding CTRL, press P, release P, press Q, release Q, and release CTRL

Managing your server after the docker installation:
(these commands only works if you created a fixed container)

# Starts your server, use CTRL+P+Q to detach without stopping
docker start powernukkit -i
# Attach a detached server
docker attach powernukkit
# Stops your server with system signal
docker stop powernukkit
# Uninstall the container (keeps the data), useful to update your server
docker rm powernukkit

Check the docker-compose.yml file for more details.

Supported tags

  • bleeding (⚠️ use with care, may contains unstable code! ⚠️)
  • 1.3.1.5, 1.3.1, 1.3, 1, latest
  • 1.3.1.4
  • 1.3.1.3
  • 1.3.1.2
  • 1.3.1.1
  • 1.3.0.1, 1.3.0
  • 1.2.1.0, 1.2.1, 1.2
  • 1.2.0.2, 1.2.0
  • 1.1.1.1, 1.1.1, 1.1
  • 1.1.1.0

Contributing

Please read the CONTRIBUTING guide before submitting any issue. Issues with insufficient information or in the wrong format will be closed and will not be reviewed.


YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications.
YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.