1.15 support.
![[IMG]](//proxy.spigotmc.org/e0784aa55b0011b4c72235771df7397aaf9af3f4?url=https%3A%2F%2Fi.imgur.com%2F4uIsJsT.png)
There are no known incompatibilities; however, no guarantees that this plugin will work with packet-modifying plugins such as ViaVersion or ProtocolSupport.
There are a few differences between the two renderers (the mount-based renderer or the teleport-based renderer). Here is a comparison table:
![[IMG]](//proxy.spigotmc.org/831bfd20d879ccd1d104672487d69451308fef7c?url=https%3A%2F%2Fi.imgur.com%2FEkzFaZC.png)
But, to prove it can do crazy things, here's a GIF from testing.
Note to developers: You should allow users to configure the priority.
* Steps to reproduce
* Expected behaviour
* Actual outcome
* Minecraft version (Only 1.13 is officially supported)
<dependency>
<groupId> net.iso2013.mlapi < / groupId>
<artifactId> MultiLineAPI < / artifactId>
<version> 2.1.2-SNAPSHOT < / version>
< / dependency>
Description
MultiLineAPI is an easy to use API that allows the server to display infinite lines of text under the nametag for each player, and allows an entity's nametag to be changed (without the limitations of other methods - see below for more information).MultiLineAPI vs Scoreboards and other alternatives
![[IMG]](http://proxy.spigotmc.org/e0784aa55b0011b4c72235771df7397aaf9af3f4?url=https%3A%2F%2Fi.imgur.com%2F4uIsJsT.png)
Compatibility and Dependencies
MultiLineAPI currently requires PacketEntityAPI, which requires ProtocolLib. PacketEntityAPI is used to provide viewer-dependant lines and the more efficient fake entities used by this library. This provides an advantage in stability because even if there is an issue where tags become separated from their targets, they will be reset upon re-login without any changes to the actual world. Furthermore, the mount-based renderer uses a few entities that, because of PacketEntityAPI, do not have to be ticked server-side.There are no known incompatibilities; however, no guarantees that this plugin will work with packet-modifying plugins such as ViaVersion or ProtocolSupport.
Commands & Permissions
MultiLineAPI currently does not have any commands or permissions.Configuration
MultiLineAPI has a very light configuration, which is used to let you select the proper renderers and configure the line spacings. Here it is:
Code (Text):
#MUST be 'MOUNT' or 'TELEPORT'
defaultRenderer: "MOUNT"
#Here are the options for each renderer
options:
lineHeight: 0.28
bottomLineHeight: 0.12
teleport:
animated: true
#Here you can define overrides for specific entity types to use one or the other. The key must be the name of the entity
#type, found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
typeRenderers:
ARROW: "TELEPORT"
DRAGON_FIREBALL: "TELEPORT"
ENDER_PEARL: "TELEPORT"
ENDER_SIGNAL: "TELEPORT"
UNKNOWN: "MOUNT"
defaultRenderer: "MOUNT"
#Here are the options for each renderer
options:
lineHeight: 0.28
bottomLineHeight: 0.12
teleport:
animated: true
#Here you can define overrides for specific entity types to use one or the other. The key must be the name of the entity
#type, found here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/entity/EntityType.html
typeRenderers:
ARROW: "TELEPORT"
DRAGON_FIREBALL: "TELEPORT"
ENDER_PEARL: "TELEPORT"
ENDER_SIGNAL: "TELEPORT"
UNKNOWN: "MOUNT"
![[IMG]](http://proxy.spigotmc.org/831bfd20d879ccd1d104672487d69451308fef7c?url=https%3A%2F%2Fi.imgur.com%2FEkzFaZC.png)
Known Limitations
With the teleportation-based renderer, sometimes the entities may become separated from their targets. If this happens, please re-log and create an issue with steps to reproduce it so MLAPI can be improved.API Usage
MultiLineAPI is designed as an API. It is not meant to be used as a plugin on its own. As such, it will not do anything unless another plugin has been installed that depends upon it. API documentation is available here .Frequently Asked Questions:
Q: Does MultiLineAPI support entities?
Yes!Q: Is there a limit on how many lines a tag can have?
Nope. However, I would suggest that you keep it to a maximum of four as a rule of thumb.But, to prove it can do crazy things, here's a GIF from testing.
Q: How is the order of added lines determined?
Registered tag controllers provide a priority for their name changes and their added lines. Higher priority lines are shown above lower priority lines.Note to developers: You should allow users to configure the priority.
Images
Coming soon!Issues
You may report issues here . Please include the following information, otherwise your report will be ignored:* Steps to reproduce
* Expected behaviour
* Actual outcome
* Minecraft version (Only 1.13 is officially supported)
For Developers
HTML:
<repositories>
<repository>
<id> frost-repo < / id>
<url> https://repo.frostalf.net/ < / url>
< / repository>
< / repositories>
<repository>
<id> frost-repo < / id>
<url> https://repo.frostalf.net/ < / url>
< / repository>
< / repositories>
HTML:
<dependency>
<groupId> net.iso2013.mlapi < / groupId>
<artifactId> MultiLineAPI < / artifactId>
<version> 2.1.2-SNAPSHOT < / version>
< / dependency>
Source Code
![[IMG]](http://proxy.spigotmc.org/c204f3a21bdcc765e90deb283e2d2de180569e26?url=https%3A%2F%2Fcdn0.iconfinder.com%2Fdata%2Ficons%2Focticons%2F1024%2Fmark-github-128.png)
Documentation
The documentation site is available on my GitHub page here .
Donations:
Want to donate to continue MultiLineAPI's development? I accept donations here:
![[IMG]](//proxy.spigotmc.org/3b67e0464f5956c65f6f94139356c0a94deeb63e?url=https%3A%2F%2Fiso2013.github.io%2FMultiLineAPI%2Fpaypal.png)
Previous Donors: Donors can PM me to receive a shoutout here, including their server's IP.
[/html]![[IMG]](http://proxy.spigotmc.org/3b67e0464f5956c65f6f94139356c0a94deeb63e?url=https%3A%2F%2Fiso2013.github.io%2FMultiLineAPI%2Fpaypal.png)
Previous Donors: Donors can PM me to receive a shoutout here, including their server's IP.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.12, 1.13, 1.14
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
MultiLineAPI is a free Minecraft Java mod. Compatible with Minecraft 1.12, 1.13, 1.14, 1.15. Downloaded 3,628 times (via Spigot). Download it and open it directly in the game.