Getting started - eldoriarpg/BloodNight GitHub Wiki

Welcome to the getting started guide.
This guide will help you to perform a basic setup of blood night.

Installation

  • Make sure you use the required version of spigot or paper (As of 04.11.2020 1.16.x).
  • Drop Blood Night into your plugin directory.
  • Restart your server.

Configuration

Now we need to configure the plugin.
This guide will not provide in depth configuration for the plugin.
We will only cover mandatory settings which are required for a good play experience.
You may want to consult our configuration page if you want to know what a setting does.

Configuration File

You wont have to change anything in the configuration file in the most cases.
You may want to change something in the general settings, since you can't change these ingame.
You may also want to use our preconfigured mob configuration.

If you added the mobs or did some changes to the general config you have to reload the plugin via /bn reload.

Permissions

You may want to give yourself the permission bloodnight.admin.*.
See our Commands & Permission Page for further informations

Text UIs

This plugin does not use complex command syntax.
Every setting is wrapped into text uis. If you are not familiar with these uis read this.

Configuring your World.

Use the /bn manageWorlds command to open the world configuration.
Click on enable next to the world name to enable blood night in a world.

Configuring general Mobs

The general mob settings can be opened by /bn manageMobs. You will always edit the world you are currently in. You can also add the world name to change the settings of another world.

You may want to change the spawn percentage.
You may want to hide the mob names.\

If you used the preconfigured mobs, changing the monster and damage health will have no effect, since they all override the default settings.

But you may want to change the settings of the vanilla mobs and you may want to set a drop mode.

Configuring Drops

Configuring Drops is quite easy.
It can be done in general in the manageMobs settings or per mob in the manageMob settings. See below for the last one. When you click on [content] a inventory will open.

Fill this inventory with the item you want the mobs to drop.
You may have notices that the example inventories has some items two or three times. This is because the stack size matters. If you put in 4 bones, the mob will drop 4 bones.

After closing the UI click on the weight button. Every item has a weight now. This can be a value between 1 and 100.
Raise the value with a left click and lower the value with a right click. Press shift to change the value by 10.
Close the inventory to save.

Notice
After you saved an item it will not be exactly the same than before when taking it out of the inventory again. This is intended behaviour and is caused by nbt tags to serialize the inventory again for saving.
The drops however will be the item you initially put in. So dont worry about this.

Configuring each mob

Of course you can configure each mob for itself.
This menu is very familiar to the manageMobs menu.
You can open it by /bn manageMob <group> where group is the group of the mob. The tab completion will help you here.

You can enable or disable every mob here.

You can also set custom drops for every mob.
If you set custom drops you may want to override the default drops. If not the drops will be combined to one pool of items.

Configure your night

Open the night settings with the /bn manageNight command.
The active setting here is the same than in world settings, so you may not want to change this here.

You may want to change the night begin and end here.
You may also want to override the night duration if you want to have longer nights.
The night duration setting will only be visible when override duration is enabled.

Configure Night Selection

The night selection defines under which cases a night will become a blood night.
The menu can be opened by /bn nightSelection

You may want to change the selection type here.

The random selection will use a percentage to define if a night becomes a blood night.

The moon phase will use a percentage based on the current moon phase.

The interval will force a blood night every x nights. A percentage can be added here too.

Done

You are done. You can use the /bn forcenight command to test your settings.
Good luck out there and dont get yourself killed too easy.
If you have any questions feel free to join our discord.

⚠️ **GitHub.com Fallback** ⚠️