✓ EisenRadar | Premium Boss-Bar Radar [MC 1.9-1.12] 1.3.1

Tested Minecraft Versions:

• 1.9
• 1.10
• 1.11
• 1.12
• 1.13

Languages Supported:
English (en_us), German (de_de)



EisenRadar is a plugin which allows you to create configurable boss-bar radars for your worlds. You can do this easily through both commands and configuration files.

Performance
EisenRadar draws all radar bars asynchronously from the main thread. This means that you can have hundreds of players viewing a radar bar without your server's main functions being delayed.

Stability
EisenRadar saves all of its radars whenever the world saves. This means that you won't lose any of your custom waypoints if the server crashes.

Localization
When you add language files to your plugins/EisenRadar/lang folder, players who are using the same languages will receive your custom messages.

Example: If a German player (using language de_de.lang in their resource pack) joins the server, messages from lang/de_de.lang on your server will be sent to them.

EisenRadar automatically detects the locale of players and chooses the right messages for them.

Update Information
The plugin automatically informs operators if a new version has been released after they join the server.





In this screenshot you can see a very simple radar. The radar has dots at the cardinal directions (N,E,S,W) and a small x marking the world's origin by default.

x and W are visible because the player is looking into the west and the origin of the world is westwards of them. The colored dots P and Z are custom dots, added by the player.


This screenshot shows example output of the /radar list command.



EisenRadar uses only a single command to avoid clashes with other plugins. That command is /radar.

/radar add <id> <symbol> (<yaw>|<x> <z>)
Adds a radar dot with a given symbol and yaw or location.
Example: /radar add waypoint1 &cX 1 2
Adds a dot named "waypoint1" with the symbol X at x=1, z=2.

/radar edit <id> infrange (true|false)
Sets whether an existing radar dot should bypass the waypoint range of the world. If so, it will always be displayed, no matter how far the player is. This setting is meaningless for fixed-yaw radar dots.

/radar edit <id> symbol <symbol>
Edits the symbol of an existing radar dot with a given id in your world.

/radar edit <id> pos (<yaw>|<x> <z>)
Edits the position of an existing radar dot with a given id in your world. If you provide one number for the position, it will be displayed at a fixed angle (yaw). If you provide two numbers, the dot will be displayed at a fixed location in the world.

/radar list
Lists all radar dots in your world.
For an example output, look into the screenshots section.

/radar on
Turns your radar on.

/radar off
Turns your radar off.

/radar remove <id>
Removes a dot with a given id.

/radar settings wprange [infinite|<range>]
Displays the current waypoint range or sets it, if a range is provided. The range can either be the literal "inf" or "infinite" or it can be a positive real number.

/radar toggle
Toggles your radar on or off. If your radar is on, it will be disabled. If your radar is off, it will be enabled.

/radar tracker (death|player) (on|off)
Enables or disables a tracker in your world.

/radar trackers
Shows a list of all trackers in your world.

/eisenradar info
Shows information about the plugin's state.

/eisenradar reload
Reloads the plugin's config and the waypoints / trackers / radar dots of worlds.

/eisenradar save [world]
Saves the waypoints / trackers / radar dots of all worlds or just a single world.



This is the default plugin config.
Code (YAML):
# the amount of ticks to wait between each radar bar update
# at least 1, values below will be clamped
# TIP: the lower the period, the smoother the radar bar will feel to players
# TIP: if you are experiencing performance issues, increasing the period can reduce lag
# default = 1
period: 1

# automatically save all radar dots and world setting whenever the world saves
# this can prevent data loss in the event of a server crash or a power outage
# pick either: true | false
# default = true
autosave: true

# radar options
radar:

# the field of view
# between 0 and 360, values outside this range will be clamped
# default = 90
fov: 90

# the amount of characters that the radar content will take up
# at least 0, values below will be clamped
# TIP: use an uneven number so that radar dots can be positioned directly in the center of the bar
# default = 31
size: 31

# boss bar options
bossbar:

# the color of the boss bar
# pick one from: BLUE | GREEN | PINK | PURPLE | RED | WHITE | YELLOW
# default = BLUE
color: BLUE

# the style of the boss bar
# pick one from: SEGMENTED_6 | SEGMENTED_10 | SEGMENTED_12 | SEGMENTED_20 | SOLID
# default = SEGMENTED_6
style: SEGMENTED_6

# list of boss bar flags (may be empty)
# pick multiple from: CREATE_FOG | DARKEN_SKY | PLAY_BOSS_MUSIC
# default = []
flags: []

# bar percentage
# between 0 and 100, values outside this range will be clamped
# default = 0
progress: 0
EisenRadar stores all its radar dots in plugins/EisenRadar/radars/<world_name>.yml. Here is an example of such a file:
Code (YAML):
dots:
east:
symbol: E
yaw: 270.0
south:
symbol: '&9S'
yaw: 0.0
north:
symbol: '&cN'
yaw: 180.0
origin:
symbol: '&lx'
x: 0.0
z: 0.0
west:
symbol: W
yaw: 90.0
point:
symbol: '&c&lP'
x: 96.0
z: 64.0
point2:
symbol: '&9&lZ'
x: 96.0
z: 0.0
It is possible to edit these files by hand and edit, remove and add radar dots that way, however DO NOT do this when the server is running, else your files will be overwritten.



eisenradar.view.on
Enable viewing the radar
eisenradar.view.off
Disable viewing the radar
eisenradar.view.toggle
Toggle viewing/not viewing the radar

eisenradar.get.list
Get a list of radars
eisenradar.get.info
Get info about the plugin's state
eisenradar.get.trackers
Get info about the world's trackers

eisenradar.set.add
Add a radar dot
eisenradar.set.remove
Remove a radar dot
eisenradar.set.edit
Edit a radar dot
eisenradar.set.settings
Edit world settings
eisenradar.set.tracker
Edit trackers in your world

eisenradar.admin.reload
Reload the plugin
eisenradar.admin.save
Save radar maps (for worlds)

eisenradar.command.radar
/radar
eisenradar.command.eisenradar
/eisenradar

Green=Default
Red=Operator-Only