- Native Minecraft Version:
- Legacy (< 1.13)
- Tested Minecraft Versions:
- 1.8
- 1.9
- 1.10
- 1.11
- 1.12
- 1.13
- 1.14
- 1.15
- 1.16
- 1.17
- Source Code:
- https://github.com/2lstudios-mc/hamsterapi
- Contributors:
- LinsaFTW
- Donation Link:
- https://paypal.me/sammwy
What is HamsterAPI?
HamsterAPI is a small library for listening to incoming and outgoing packets, reading, modifying and canceling them.
It also allows you to easily send packages to users without the need to use Reflection or NMS in your plugin.
What can i do with HamsterAPI?
- Send Title, Subtitle, ActionBar, and Packets to players.
- Listen incoming and outgoing packets with events based on priority and cancellation.
- Disconnect players safely/instantly.
- Communicate with BungeeCord. (Kick, switch server, send message channel, etc)
In the future, HamsterAPI will also have:
1. BossBar API
2. Client <-> server communication with custom channels (For modded clients)
3. Bungeecord Listener
How to use HamsterAPI?
The first step is to get the HamsterAPI instance to access most of the methods of the API with the static method HamsterAPI.getInstance().
From the HamsterAPI instance you can access the following methods:
getBufferIO() - Util to split/decompress/decode bytebufs into packets.
getBungeeMessenger() - Util to ease CustomPayload communication with BungeeCord.
getReflection() - Optimized util to get NMS and CraftBukkit classes without losing compatibility.
getPacketInjector() - Util to inject/remove HamsterAPI from the pipeline of a player.
You can listen to the following events:
PacketDecodeEvent
PacketReceiveEvent
PacketSendEvent
Decode is ran after splitter & decompress on the pipeline and lets you access to a bytebuf object. You can decode it with BufferIO to get a PacketWrapper object. (Perfect for exploit fixing and security stuff)
Receive/Send is ran after decode on the pipeline and lets you access to a PacketWrapper object. (Perfect for cosmetic/common stuff)
To know how to listen to Events please read the following guide: https://www.spigotmc.org/wiki/using-the-event-api/
Code (Java):Code (Java):Code (Java):
HamsterAPI.getInstance().getHamsterPlayerManager().get(player).closeChannel();
Code (Java):
[Developers] Don't forget to place HamsterAPI as a dependency in your "plugin.yml" file

[2LS] HamsterAPI 0.2.3
Simple and easy to use API to read and write Packets.
-
RatovelhoRL, Khuirul_Huda, Indetectable_ and 7 others like this.
Recent Updates
- HamsterAPI | Update 0.2.3 Apr 14, 2022
- HamsterAPI | Update 0.2.2 Oct 15, 2021
- HamsterAPI | Update 0.2.1 Oct 14, 2021
Recent Reviews
-
Facund123
- 4/5,
[19:14:53 WARN]: [HamsterAPI] Failed to inject player chiki please contact 2LStudios for support about HamsterAPI as this can lead to vulnerabilities. , este error me salta
-
Osurac
- 2/5,
Works great on older versions, but failing to inject on 1.18 - no word from the developer, so I will alter my review once it is updated.
-
Author's Response
HamsterAPI should already be compatible with 1.18, when you like you can try.
-
Sleepyflea
- 3/5,
Good plugin but failing to inject player on latest release. Please fix this so i can use it
-
Author's Response
We will start working on the 1.18+ implementation from now on.
-
dayofpaybg
- 4/5,
This plugin is causing Memory Leak in my server, the plugin is good but there is something wrong with it
-
Author's Response
Hello, you can enable memory leak detector in spigot to help me to solve that.
Start your server with this argument flag:
-Dio.netty.leakDetection.level=PARANOID
-
yearapu
- 5/5,
this plugin cause my server lag I like this plugin but now this plugin is a exploit .
-
Author's Response
Can you join our discord server to see that issue? https://discord.gg/rWKXyJr
-
Thundurh
- 5/5,
Love this plugin. Prevents many exploits, and DDOSers from infiltrating your server! Super good.
-
brs73
- 5/5,
Same than OldPast.
Linsa makes good plugins for free :)
%-%-%-%-%-%-%-%-%-%-%-%-% -
OldPast
- 5/5,
Seis tem que parar de ser idiota, e mostrar o erro no privado do desenvolvedor no Discord, pra ele poder arrumar, deste jeito, vocês baixam a moral do cara, ele sempre me trato com muita educação, e, não ficar com essa putaria de dar estrela baixa por meros erros, vocês sabem o que é passar dias trabalhando pra fazer algo de graça, e... Ser recebido desta forma? O trabalho do cara é incrível, ele tem uma network bem famosa, eu no lugar dele, nunca jamais liberaria sistemas de proteção tão impecáveis bem como o dele, ta na hora de crescer, não acha? Vocês estão criando um servidor, um servidor que provavelmente pessoas confiarão seu tempo para jogar, então... Cresçam, por favor!!
-
Sentello
- 2/5,
[HamsterAPI] Failed to setup "for everyone players"
Reason: Tried to access field from a null object -
EzXabi
- 1/5,
[22:53:43 INFO]: [HamsterAPI] Retrying injection to player Inappropriates! Reason: java.lang.IllegalAccessException
this happends on first join