# PayloadLib<\/p>\n
Easier approach for **Paper** servers to send & handle custom payloads, simple & powerful.<\/p>\n
Please refer to our GitHub Repository for more information.<\/p>\n
## Importing<\/p>\n
To access the snapshot version of PayloadLib, please add this in your `build.gradle`:<\/p>\n
“`groovy
\nrepositories {
\n maven {
\n name = ‘Central Portal Snapshots’
\n url = ‘https:\/\/central.sonatype.com\/repository\/maven-snapshots\/’
\n }
\n}<\/p>\n
dependencies {
\n implementation ‘top.nlrdev:payloadlib:0.0.2-SNAPSHOT’<\/p>\n
\/\/ Optional dependency, providing ByteBuf
\n implementation ‘io.netty:netty-buffer:4.2.2.Final’
\n}
\n“`<\/p>\n
Embedding this plugin within other plugin JARs is not recommended, as it can lead to various issues.<\/p>\n
## Supported Data Types<\/p>\n
### Primitive<\/p>\n
| Primitive | Packaged | Array | Unsigned Implementation |
\n| ——— | ——— | ————- | ——————————————- |
\n| boolean | Boolean | _Unsupported_ | _None_ |
\n| byte | Byte | byte[] | _None_ |
\n| short | Short | _Unsupported_ | `top.nlrdev.payloadlib.types.UnsignedShort` |
\n| char | Character | _Unsupported_ | _None_ |
\n| int | Integer | _Unsupported_ | _None_ |
\n| long | Long | _Unsupported_ | _None_ |
\n| float | Float | _Unsupported_ | _None_ |
\n| double | Double | _Unsupported_ | _None_ |<\/p>\n
### Non-Primitive<\/p>\n
| Type | PayloadLib |
\n| ———————- | ———– |
\n| String | _Unchanged_ |
\n| UUID | _Unchanged_ |
\n| `org.joml.Vector3f` | _Unchanged_ |
\n| `org.joml.Quaternionf` | _Unchanged_ |<\/p>\n
| Minecraft (Official) | Minecraft (Yarn) | PayloadLib |
\n| —————————————— | ———————————- | —————————————- |
\n| `net.minecraft.resources.ResourceLocation` | `net.minecraft.util.Identifier` | `top.nlrdev.payloadlib.types.Identifier` |
\n| `ByteBufCodecs#VAR_INT` | `PacketCodecs#VAR_INT` | `top.nlrdev.payloadlib.types.VarInt` |
\n| `ByteBufCodecs#VAR_LONG` | `PacketCodecs#VAR_LONG` | `top.nlrdev.payloadlib.types.VarLong` |
\n| `net.minecraft.world.phys.Vec3` | `net.minecraft.util.math.Vec3d` | `org.joml.Vector3d` |
\n| `net.minecraft.core.BlockPos` | `net.minecraft.util.math.BlockPos` | `top.nlrdev.payloadlib.types.BlockPos` |<\/p>\n
## Examples<\/p>\n
You can refer to these live examples to get inspiration:<\/p>\n
– XIAYM-gh\/SittingPlus-uwu-Bukkit<\/p>\n
## License<\/p>\n
This mod is licensed under MIT License.<\/p>\n","protected":false},"excerpt":{"rendered":"
Easier approach for Paper servers to send & handle custom payloads, simple & powerful.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"payloadlib","_minecraft_project_id":"svqvP6iP","_minecraft_author":"XIAYM-gh","_minecraft_license":"MIT","_minecraft_downloads":50,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"payloadlib.zip","_minecraft_size_bytes":31728,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:07:11.879430Z","_minecraft_date_created":"2025-07-18T03:13:35.800750Z","_minecraft_date_modified":"2025-07-12T10:13:56.468649Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/payloadlib","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T01:23:38+00:00","_minecraft_import_hash":"9c366a5d8b13dfd9aea978c2e2362187","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,127,128,92],"mod_loader":[132,133],"minecraft_version":[59,36,94,101,102,62,37,38,78,80],"class_list":["post-119905","mod","type-mod","status-publish","hentry","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20","minecraft_version-1-20-1","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-4","minecraft_version-1-21-5","minecraft_version-1-21-7"],"yoast_head":"\n