|
1 | | - |
| 1 | +# Nukkit PetteriM1 Edition |
2 | 2 |
|
3 | | -Introduction |
4 | | -------------- |
| 3 | +This is a custom version of [Nukkit](https://github.com/CloudburstMC/Nukkit), a Minecraft Bedrock Edition server software written in Java. |
5 | 4 |
|
6 | | -Nukkit is nuclear-powered server software for Minecraft Bedrock Edition. |
7 | | -It has a few key advantages over other server software: |
| 5 | +See the [wiki](https://github.com/PetteriM1/NukkitPetteriM1Edition/wiki) for more details. |
8 | 6 |
|
9 | | -* Written in Java, Nukkit is faster and more stable. |
10 | | -* Having a friendly structure, it's easy to contribute to Nukkit's development and rewrite plugins from other platforms into Nukkit plugins. |
11 | | - |
12 | | -Nukkit is under improvement yet, we welcome contributions. |
13 | | - |
14 | | -Links |
15 | | --------------------- |
16 | | - |
17 | | -* __[Forums](https://cloudburstmc.org/forums/)__ |
18 | | -* __[Discord](https://discord.gg/5PzMkyK)__ |
19 | | -* __[Wiki](https://cloudburstmc.org/wiki/nukkit)__ |
20 | | -* __[Download Nukkit](https://dl.opencollab.dev/nukkit)__ |
21 | | -* __[Download Plugins](https://cloudburstmc.org/resources/categories/nukkit-plugins.1/)__ |
22 | | - |
23 | | -Compile Nukkit |
24 | | -------------- |
25 | | -- `git clone https://github.com/CloudburstMC/Nukkit` |
26 | | -- `cd Nukkit` |
27 | | -- `./gradlew shadowJar` |
28 | | - |
29 | | -The compiled JAR can be found in the `target/` directory. |
30 | | - |
31 | | -Note: You don't need to compile Nukkit yourself if you don't intend to modify the code. |
32 | | - |
33 | | -Running |
34 | | -------------- |
35 | | -Simply run `java -jar nukkit-1.0-SNAPSHOT.jar`. |
36 | | - |
37 | | -Plugin API |
38 | | -------------- |
39 | | -Information on Nukkit's API can be found at the [wiki](https://nukkitx.com/wiki/nukkit/). |
40 | | - |
41 | | -Docker |
42 | | -------------- |
43 | | - |
44 | | -Running Nukkit in [Docker](https://www.docker.com/) (17.05+ or higher). |
45 | | - |
46 | | -Build image from the source, |
47 | | - |
48 | | -``` |
49 | | -docker build -t nukkit . |
50 | | -``` |
51 | | - |
52 | | -Run once to generate the `nukkit-data` volume, default settings, and choose language, |
53 | | - |
54 | | -``` |
55 | | -docker run -it -p 19132:19132/udp -v nukkit-data:/data nukkit |
56 | | -``` |
57 | | -Docker Compose |
58 | | -------------- |
59 | | - |
60 | | -Use [docker-compose](https://docs.docker.com/compose/overview/) to start server on port `19132` and with `nukkit-data` volume, |
61 | | - |
62 | | -``` |
63 | | -docker-compose up -d |
64 | | -``` |
65 | | - |
66 | | -Kubernetes & Helm |
67 | | -------------- |
68 | | - |
69 | | -Validate the chart: |
70 | | - |
71 | | -`helm lint charts/nukkit` |
72 | | - |
73 | | -Dry run and print out rendered YAML: |
74 | | - |
75 | | -`helm install --dry-run --debug nukkit charts/nukkit` |
76 | | - |
77 | | -Install the chart: |
78 | | - |
79 | | -`helm install nukkit charts/nukkit` |
80 | | - |
81 | | -Or, with some different values: |
82 | | - |
83 | | -``` |
84 | | -helm install nukkit \ |
85 | | - --set image.tag="arm64" \ |
86 | | - --set service.type="LoadBalancer" \ |
87 | | - charts/nukkit |
88 | | -``` |
89 | | - |
90 | | -Or, the same but with a custom values from a file: |
91 | | - |
92 | | -``` |
93 | | -helm install nukkit \ |
94 | | - -f helm-values.local.yaml \ |
95 | | - charts/nukkit |
96 | | -``` |
97 | | - |
98 | | -Upgrade the chart: |
99 | | - |
100 | | -`helm upgrade nukkit charts/nukkit` |
101 | | - |
102 | | -Testing after deployment: |
103 | | - |
104 | | -`helm test nukkit` |
105 | | - |
106 | | -Completely remove the chart: |
107 | | - |
108 | | -`helm uninstall nukkit` |
| 7 | +>[Download](https://github.com/PetteriM1/NukkitPetteriM1Edition/releases/latest) |
0 commit comments