{"id":119650,"date":"2026-06-07T03:57:52","date_gmt":"2026-06-07T00:57:52","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/"},"modified":"2026-06-07T03:57:52","modified_gmt":"2026-06-07T00:57:52","slug":"passengerapi","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/","title":{"rendered":"PassengerAPI"},"content":{"rendered":"<p><img decoding=\"async\" src=\"https:\/\/img.shields.io\/badge\/Discord_Server-7289DA?style=flat&#038;logo=discord&#038;logoColor=white\" alt=\"Join Discord Server\" style=\"border-radius: 15px; height: 20px;\">  <\/p>\n<p># Why Use PassengerAPI?<br \/>\nIt solves compatibility issues that may arise when different plugins create entities<br \/>\nby sending packets to players and setting them as passengers.<br \/>\nThis can lead to conflicts and unintended behavior like unmounting of previous set passengers by other plugins.<\/p>\n<p>For example this makes these plugins automatically compatible with each other:<br \/>\n&#8211; Better Chat Bubbles<br \/>\n&#8211; ProdigyCape<br \/>\n&#8211; VanillaMinimaps<br \/>\n&#8211; PlayerMounts<\/p>\n<p>This plugin **works out-of-the-box!**<br \/>\nJust put it into your plugins folder and restart your server.<br \/>\n(Requires Packet Events)<\/p>\n<p># Showcase<\/p>\n<p><iframe loading=\"lazy\" width=\"560\" height=\"315\" src=\"https:\/\/www.youtube-nocookie.com\/embed\/1anBRDFuUdw\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe><\/p>\n<p>**Video explanation**<br \/>\nAs you can see in the video:<\/p>\n<p>The Chat Bubbles and capes are cannot be set as a passenger at the same time without PassengerAPI!<\/p>\n<p>Reason for this is that they are both two different plugins, which are sending their own passenger packet.<\/p>\n<p>If you are a **developer** can also add\/access\/remove passengers using this API!  <\/p>\n<p>(Most compatibility problems should automatically be fixed but&#8230;)<\/p>\n<p>For example if you want to remove a passenger from an entity, without killing it, this could be usefull.<\/p>\n<p># Commmands:<\/p>\n<p>Permission `passengerapi.commands`<\/p>\n<p>&#8220;`<br \/>\n\/passengerapi debug<br \/>\n\/passengerapi reload<br \/>\n&#8220;`<br \/>\n> Note<br \/>\n> When you are in debug mode and holding a block in your hand<br \/>\n> you will get additional debugging in chat.<\/p>\n<p># Config:<\/p>\n<p>&#8220;`yml<br \/>\n# DO NOT TOUCH ANYTHING IN THIS FILE<br \/>\n# IF YOU ARE NOT 100% SURE WHAT YOU ARE DOING!<\/p>\n<p>AutoPassengerDetection:<br \/>\n  SetPassengerPacket: true<br \/>\n  EntityDestroyPacket: true<br \/>\n&#8220;`<\/p>\n<p># Getting Started<\/p>\n<p>1. Add PassengerAPI as a compile-only dependency to your plugin.<\/p>\n<p>Gradle:<br \/>\n&#8220;`gradle<br \/>\nrepositories {<br \/>\n    mavenCentral()<br \/>\n    maven { url &#8216;https:\/\/jitpack.io&#8217; }<br \/>\n}<\/p>\n<p>dependencies {<br \/>\n    implementation &#8216;com.github.max1mde:PassengerAPI:1.0.1&#8217;<br \/>\n}<br \/>\n&#8220;`<br \/>\n(For maven: https:\/\/jitpack.io\/#max1mde\/PassengerAPI\/1.0.0)  <\/p>\n<p>2. Add the following line to your `plugin.yml` file:<br \/>\n&#8220;`<br \/>\ndepend:<br \/>\n&#8211; PassengerAPI<br \/>\n&#8220;`<\/p>\n<p>Also add the plugin Packet Events to your server<br \/>\nwhich is required by this plugin!<\/p>\n<p># Usage<\/p>\n<p>### Obtaining the PassengerActions Instance<\/p>\n<p>To access the PassengerAPI functionality, you need to obtain the PassengerActions instance:<\/p>\n<p>&#8220;`java<br \/>\nPassengerActions passengerActions = PassengerAPI.getAPI(yourPluginInstance);<br \/>\n&#8220;`<br \/>\nReplace yourPluginInstance with the instance of your plugin&#8217;s main class.<br \/>\n(For example with `this` if you use it in your main class)<\/p>\n<p>### Managing Passengers<\/p>\n<p>Here are some examples of how to use the `PassengerActions` interface:<\/p>\n<p>Keep in mind that you can only retrive and remove passengers, which you have set here by using the addPassenger&#8230; methods.<br \/>\n**Except:** when using the &#8220;global&#8221; methods like getGlobalPassengers.<\/p>\n<p>&#8220;`java<br \/>\n\/\/ Add a single passenger<br \/>\npassengerActions.addPassenger(targetEntityId, passengerEntityId);<\/p>\n<p>\/\/ Add multiple passengers<br \/>\npassengerActions.addPassengers(targetEntityId, Set.of(passenger1Id, passenger2Id, &#8230;));<\/p>\n<p>\/\/ Remove a single passenger<br \/>\npassengerActions.removePassenger(targetEntityId, passengerEntityId);<\/p>\n<p>\/\/ Remove multiple passengers<br \/>\npassengerActions.removePassengers(targetEntityId, Set.of(passenger1Id, passenger2Id, &#8230;));<\/p>\n<p>\/\/ Remove all passengers for a target entity<br \/>\npassengerActions.removeAllPassengers(targetEntityId);<\/p>\n<p>\/\/ Get all passengers for a target entity<br \/>\nSet<Integer> passengers = passengerActions.getPassengers(targetEntityId);<\/p>\n<p>\/\/ Remove global passengers (passengers set by all plugins)<br \/>\npassengerActions.removeGlobalPassengers(targetEntityId, Set.of(passenger1Id, passenger2Id, &#8230;));<\/p>\n<p>\/\/ Remove all global passengers for a target entity (passengers set by all plugins)<br \/>\npassengerActions.removeAllGlobalPassengers(targetEntityId);<\/p>\n<p>\/\/ Get all global passengers for a target entity (passengers set by all plugins)<br \/>\nSet<Integer> globalPassengers = passengerActions.getGlobalPassengers(targetEntityId);<br \/>\n&#8220;`<\/p>\n<p>> Note<br \/>\n> All entities are identified by their entity ID (not UUID).<\/p>\n<p>### Listening to events<\/p>\n<p>PassengerAPI also provides events that you can listen to and handle accordingly:<\/p>\n<p>&#8220;`java<br \/>\n@EventHandler<br \/>\npublic void onAddPassenger(AddPassengerEvent event) {<br \/>\n    \/\/ The name of the plugin which tries to add these passengers<br \/>\n    String pluginName = event.getPluginName();<br \/>\n    int targetEntity = event.getTargetEntityID();<br \/>\n    Set<Integer> passengers = event.getPassengerList();<br \/>\n    \/\/ Perform actions with these properties<br \/>\n}<\/p>\n<p>@EventHandler<br \/>\npublic void onRemovePassenger(RemovePassengerEvent event) {<br \/>\n    \/\/ The name of the plugin which tries to remove these passengers<br \/>\n    String pluginName = event.getPluginName();<br \/>\n    int targetEntity = event.getTargetEntityID();<br \/>\n    Set<Integer> removedPassengers = event.getPassengerList();<br \/>\n    \/\/ Perform actions with these properties<br \/>\n}<\/p>\n<p>@EventHandler<br \/>\npublic void onPassengerPacket(PassengerPacketEvent event) {<br \/>\n    int targetEntity = event.getTargetEntityID();<br \/>\n    Set<Integer> passengers = event.getPassengerList();<br \/>\n    \/\/ Which players should receive the packet (You can modify that list)<br \/>\n    List<Player> receivers = event.getPacketReceivers();<br \/>\n    \/\/ Perform actions with these properties<br \/>\n}<br \/>\n&#8220;`<br \/>\nDon&#8217;t forget to register your event class <\/p>\n<p># Contributions on GitHub are welcome!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Fix passenger compatibility issues | Manage your own entity passengers<\/p>\n","protected":false},"featured_media":119651,"template":"","meta":{"_minecraft_slug":"passengerapi","_minecraft_project_id":"jWuRWJTt","_minecraft_author":"maximjsx","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":320,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"passengerapi.zip","_minecraft_size_bytes":179481,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T11:35:41.793266Z","_minecraft_date_created":"2024-05-31T22:17:20.169356Z","_minecraft_date_modified":"2025-08-09T11:15:37.041923Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/passengerapi","_minecraft_icon_attachment_id":119651,"_minecraft_imported_at":"2026-06-07T00:57:52+00:00","_minecraft_import_hash":"abbdd308c7b2709edf83930136d8e69e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,122,90,127,128,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-119650","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-magic","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>PassengerAPI - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PassengerAPI - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Fix passenger compatibility issues | Manage your own entity passengers\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/img.shields.io\/badge\/Discord_Server-7289DA?style=flat&logo=discord&logoColor=white\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/\",\"name\":\"PassengerAPI - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/passengerapi-icon-0f3cd4c4b03eeff9cd63bc1a16a4cf33df8cdc9b_96.webp\",\"datePublished\":\"2026-06-07T00:57:52+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/passengerapi-icon-0f3cd4c4b03eeff9cd63bc1a16a4cf33df8cdc9b_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/passengerapi-icon-0f3cd4c4b03eeff9cd63bc1a16a4cf33df8cdc9b_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/passengerapi\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PassengerAPI\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PassengerAPI - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/","og_locale":"en_US","og_type":"article","og_title":"PassengerAPI - Minecraft","og_description":"Fix passenger compatibility issues | Manage your own entity passengers","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/img.shields.io\/badge\/Discord_Server-7289DA?style=flat&logo=discord&logoColor=white","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/","name":"PassengerAPI - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/passengerapi-icon-0f3cd4c4b03eeff9cd63bc1a16a4cf33df8cdc9b_96.webp","datePublished":"2026-06-07T00:57:52+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/passengerapi-icon-0f3cd4c4b03eeff9cd63bc1a16a4cf33df8cdc9b_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/passengerapi-icon-0f3cd4c4b03eeff9cd63bc1a16a4cf33df8cdc9b_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/passengerapi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PassengerAPI"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/119650","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/119651"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=119650"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=119650"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=119650"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=119650"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}