MinibloxTranslationLayer

A middle man to translate Miniblox packets into Minecraft 1.8.9 packets.

Progress

Improvements from the original

• /planets selection gui (it's not really good since there's no filtering and paging, but better than nothing)
• /join accepts miniblox invite codes along with server IDs
• more commands: /serverinfo, /serverid / /id / /invite, and /next
• migrated to ESM (better code)
• more items are mapped
• handles more packets (disconnect packet, queue next packet, and the creative mode set slot packet)

Handled S2C Packets

• CPacketAnimation
• CPacketBlockAction
• CPacketBlockUpdate
• CPacketChangeServers (idk what this does, just logs the url field to the console)
• CPacketChunkData
• CPacketCloseWindow
• CPacketConfirmTransaction
• CPacketDestroyEntities
• CPacketDisconnect (waits for the connection to actually be closed)
• CPacketEntityAction
• CPacketEntityEquipment
• CPacketEntityMetadata
• CPacketEntityPositionAndRotation
• CPacketEntityRelativePositionAndRotation
• CPacketEntityStatus
• CPacketEntityVelocity
• CPacketExplosion (should work)
• CPacketJoinGame
• CPacketLeaderboard (untested)
• CPacketLocalStorage (not required, so no)
• CPacketMessage
• CPacketOpenWindow
• CPacketParticles
• CPacketPlayerList
• CPacketPlayerPosition
• CPacketPlayerPosLook
• CPacketPlayerReconciliation
• CPacketPong
• CPacketRespawn
• CPacketScoreboard
• CPacketServerInfo
• CPacketSetSlot
• CPacketSignEditorOpen
• CPacketSoundEffect
• CPacketSpawnEntity
• CPacketSpawnPlayer
• CPacketTabComplete
• CPacketTitle
• CPacketUpdate
• CPacketUpdateHealth
• CPacketUpdateLeaderboard (untested)
• CPacketUpdateScoreboard
• CPacketUpdateSign
• CPacketUpdateStatus
• CPacketWindowItems
• CPacketWindowProperty
• CPacketUseBed
• CPacketQueueNext
• CPacketSpawnExperienceOrb
• CPacketSetExperience
• CPacketOpenShop
• CPacketShopProperties
• CPacketEntityProperties
• CPacketEntityEffect
• CPacketRemoveEntityEffect
• CPacketUpdateCommandBlock
• CPacketEntityAttach
• CPacketServerMetadata
• CPacketTimeUpdate

Handled C2S Packets

• SPacketAdminAction
• SPacketAnalytics (sends fake data)
• SPacketClickWindow
• SPacketCloseWindow
• SPacketConfirmTransaction
• SPacketEnchantItem
• SPacketEntityAction
• SPacketHeldItemChange
• SPacketLoginStart
• SPacketMessage
• SPacketOpenShop
• SPacketPing
• SPacketPlayerAbilities
• SPacketPlayerAction
• SPacketPlayerPosLook
• SPacketRespawn
• SPacketTabComplete
• SPacketUpdateSign
• SPacketUseEntity
• SPacketUpdateCommandBlock
• SPacketQueueNext
• SPacketPlayerInput
• SPacketBreakBlock
• SPacketClick
• SPacketCraftItem
• SPacketPlaceBlock
• SPacketRequestChunk
• SPacketUpdateInventory (creative mode)
• SPacketUseItem

Use Steps

1. Install the latest NodeJS at (https://nodejs.org/)
2. Download & extract the repository to a folder of your choosing
3. Open a terminal inside said folder (on windows you can open the folder in explorer, select the path, and replace it all (CTRL + A and Backspace))
4. Run npm install to install the dependencies
5. Run node . to run the translation layer
6. Connect to localhost on ANY(*) Minecraft 1.8.9 client.

*: servers which use the new anti-cheat (SkyWars, EggWars, the bridge, Classic PvP, and KitPvP) need custom code to send the C0CInput packet. (sadly 1.21.2+ clients send input packets that get discarded by ViaVersion if you're not in a boat)

Commands

Here below is listed all of the commands from the translation layer.

/play, /queue, and /q

Syntax: /q [gamemode] ([gamemode] can be autocompleted using the TAB)

Joins a server matching the gamemode criteria. skywars is the default gamemode

/login

Syntax: /login <token>

Writes token to login.token so the translation layer can use it once you rejoin. Rejoin for the changes to take effect.

/join

Syntax: /join <server ID or invite code>

Joins a specific server. A server ID looks like this: {server size, e.g. small, large, medium, or planet}-{ID 1}-{ID 2}. An invite code looks like this: https://miniblox.io/?join=INVITECODE or just INVITECODE

/resync

Syntax: /resync

Setbacks you to the last place you were teleported to, This helps fix view angle de-syncs caused by the "new" anti-cheat. You can also abuse this to go faster on the new anti-cheat, vector best developer of 2025!?!?!

/reloadchunks

Syntax: /reloadchunks

Reloads... the... chunks. (like F3 + A)

/desync

Syntax: /desync

Toggles if you are de-synced on the server or not.

This makes the input sequence number not increment and interpolates your position to limit the speed to 1.98 bps (to not flag). While you are de-synced, you can do any movement, but you will be limited to effectively 2 BPS (and your rotations won't sync). You can also use this as a NoFall, simply desync when you are about to fall, and resync as soon as you hit the ground.

/serverid, /id, and /invite

Syntax: /id

Condensed version of /serverinfo that only shows the invite code and server ID, both can be used with /join.

/serverinfo

Shows all the information about this server gathered. We get all the information from the CPacketServerInfo packet (which is sent as a packet when the server info changes, and included in the CPacketJoinGame packet)

/planets

Syntax: /planets

A minimal UI for viewing planets. This is limited by the amount of items a chest can hold in Minecraft, so it's probably better just picking a server from the website and using the invite code or server ID to join on the translation layer.