#4143·mineflayer

PrismarineJS (+ ProtoDef-io) open backlog - manual review

Author: Pix3lPirat3Created Sep 18, 2026Updated Sep 18, 2026
Labelspossible bugStage1

PrismarineJS (+ ProtoDef-io) open backlog - manual review

Snapshot 2026-09-18. Open items reviewed: 1974 of 1974. Only items open at snapshot time are considered. Each row carries the evidence its recommendation rests on; maintainers decide.

The recommended closures (fixed, duplicate, answered, stale, invalid, superseded - the six largest groups) are in the companion https://github.com/PrismarineJS/mineflayer/issues/4142; this file keeps the summary and every item that stays open or needs an action.

Progress by repository

Repository Open Reviewed
mineflayer 521 521
minecraft-data 220 220
node-minecraft-protocol 140 140
flying-squid 114 114
prismarine-web-client 74 74
bedrock-protocol 71 71
prismarine-viewer 69 69
mineflayer-pathfinder 57 57
node-protodef 31 31
ProtoDef 31 31
mineflayer-collectblock 26 26
prismarine-physics 25 25
prismarine-chunk 24 24
node-minecraft-protocol-forge 23 23
prismarine-world 23 23
minecraft-wiki-extractor 22 22
mineflayer-navigate 22 22
mineflayer-statemachine 22 22
minecraft-data-generator 21 21
prismarine-auth 19 19
node-minecraft-data 16 16
prismarine-contribute 14 14
prismarine-provider-anvil 14 14
protodefc 14 14
mineflayer-pvp 13 13
node-minecraft-wrap 13 13
prismarine-proxy 13 13
prismarine-schematic 13 13
prismarine-windows 13 13
prismarine-nbt 12 12
prismarine-block 11 11
prismarine-item 11 11
prismarine-packet-dumper 11 11
mineflayer-tool 10 10
prismarine-chat 10 10
prismarine-gameplay 10 10
minecraft-assets 9 9
mineflayer-cmd 9 9
node-minecraft-assets 9 9
node-yggdrasil 9 9
numerous-alpaca 9 9
prismarine-entity 9 9
mineflayer-scaffold 8 8
mineflayer-test-api 8 8
prismarine-registry 8 8
prismarine-repo-actions 8 8
minecraft-jar-extractor 7 7
prismarine-realms 7 7
prismarine-server 7 7
prismarinejs.github.io 7 7
dazed-sheep 6 6
MineflayerArmorManager 6 6
node-mojangson 6 6
mineflayer-builder 5 5
McDataExtracting 4 4
mcdevs-wiki-extractor 4 4
minecraft-chunk-dumper 4 4
minecraft-inventory-gui 4 4
minecraft-packets 4 4
mineflayer-radar 4 4
node-nethernet 4 4
prismarine-design 4 4
prismarine-loottable 4 4
prismarine-provider-raw 4 4
prismarine-rng 4 4
node-protodefc 4 4
node-vec3 3 3
prismarine-recipe 3 3
node-protodef-validator 3 3
ProtoDef-io.github.io 3 3
burger-extractor 2 2
entity-model-extractor 2 2
minecraft-classic-protocol-extension 2 2
mineflayer-gptj 2 2
prismarine-archiver 2 2
auto-sheep 1 1
bedrock-provider 1 1
gdmc-challenge-2021 1 1
minecraft-assets-pixel-perfection 1 1
minecraft-classic-protocol 1 1
minecraft-data-auto-updater 1 1
net-browserify 1 1
node-minecraft-extractor 1 1
prismarine-meta 1 1
prismarine-monotree 1 1
prismarine-template 1 1
prismarine-world-sync 1 1
speedrun-challenge-ssgp 1 1
elixir-protodef 1 1
(not started) 0 0

Summary by recommended action

Action Items
Close as fixed 221
Close as duplicate 6
Close as answered (question, not a bug) 167
Close as stale 801
Needs a current reproduction, then close if none 17
Close as invalid or out of scope 60
Close as superseded 45
Consolidate into one tracker 106
Needs rework before it can merge 120
Ready to review or merge 172
Needs a maintainer decision 44
Keep open (valid, actionable) 187
Tracked in another repository 1
Routine bot PRs (release and workflow boilerplate) 27

Needs a current reproduction, then close if none — 17

Item Title Evidence / reason Related
PrismarineJS/bedrock-protocol#696 (issue, 2026) container_open packet missing only when using createClient (even throu container_open missing only through createClient, even via the relay (Feb 2026); detailed but zero replies. Needs a packet dump on current master.
PrismarineJS/bedrock-protocol#778 (issue, 2026) Relay Read Error Relay PartialReadError on packet 0x6c with a buffer; extremeheat asked for code/version, partial answer. One packet to decode.
PrismarineJS/minecraft-data#1001 (issue, 2025) Bedrock protocol crafting_data packet is not correctly formatted Bedrock crafting_data malformed with education features; no buffer attached.
PrismarineJS/mineflayer#693 (issue, 2018) Speed does not affect movment 2018 report that the Speed effect does not change movement; prismarine-physics has applied movement-speed attributes and effects since 2020. Ask for a current reproduction or close.
PrismarineJS/mineflayer#1368 (issue, 2020) The bot does not change its view using the bot.lookAt() method if the lookAt does not turn toward a block directly above the head (2020, reporter gave steps); no confirmation on any current version. Ask for a reproduction or close.
PrismarineJS/mineflayer#2569 (issue, 2022) openContainer cannot open some container blocks openContainer cannot open some container blocks (IceTank 2022, no list of which). Ask which blocks on a current version, else close.
PrismarineJS/mineflayer#2778 (issue, 2022) The mineflayer bot breaks blocks endlessly on a specific minecraft ser Endless digging on one specific server; waiting-info since 2023, users still asking in 2026 without a reproduction. Ask once for a version + debug log or close.
PrismarineJS/mineflayer#3378 (issue, 2024) CorruptedFrameException on 1.20.3 protocol CorruptedFrameException on Velocity 1.20.4, reported again on 4.26.0 (Feb 2025) after being mislabelled waiting-info. Needs a debug log on a current version. PrismarineJS/mineflayer#3692
PrismarineJS/mineflayer#3587 (issue, 2025) TypeError when using realms in createBot TypeError with the realms option in createBot, still asked about in Sep 2025. Needs the stack trace on a current prismarine-realms; realm support has few users to confirm. PrismarineJS/mineflayer#3581
PrismarineJS/mineflayer#3608 (issue, 2025) bot.players not returning all connected players on paperMC servers bot.players missing players on Paper 1.21.4 (2025), zero comments; PrismarineJS/mineflayer#3699 covered the 1.8.9 case and rom1504 wants a regression test. Confirm on 1.21.4 or close. PrismarineJS/mineflayer#3699
PrismarineJS/mineflayer#3688 (issue, 2025) Bot not able to detect music disc being played, in mineflayer events Jukebox/music disc sounds not surfaced on 1.21.3; logs were provided but nobody checked whether the jukebox uses the sound_effect packet or a block event. One check on a test server now that sound.js handles inline sound events. PrismarineJS/mineflayer#3329
PrismarineJS/mineflayer#3724 (issue, 2025) receiving message cause crash Crash on CJK chat and PartialReadError when many chats arrive (Dec 2025); waiting-info, but two independent reports. Needs a debug capture on a current version. PrismarineJS/mineflayer#3266
PrismarineJS/mineflayer#3747 (issue, 2025) Bots get stuck in exit end portal because they cannot skip the credits Bots stuck in the exit end portal on 1.21.8: lib/plugins/game.js:125 already answers win_game with client_command, so either the field changed (see PrismarineJS/mineflayer#4086) or the packet is missed. One check on a test server. PrismarineJS/mineflayer#4086, PrismarineJS/mineflayer#3972
PrismarineJS/mineflayer#3759 (issue, 2025) entity_teleport serialization errors on 1.21.8 entity_teleport / chunk-size serialization spam on a custom 1.21.8 server, still reported Aug 2026. Needs a buffer dump (extremeheat's auto-dump idea in PrismarineJS/mineflayer#3925) to tell server bugs from parser bugs. PrismarineJS/mineflayer#3925, PrismarineJS/mineflayer#3266
PrismarineJS/mineflayer#3765 (issue, 2025) Error with signed chat: RangeError [ERR_OUT_OF_RANGE] RangeError on signed chat checksum on 1.21.8; the node-minecraft-protocol fix PR PrismarineJS/mineflayer#1442 closed unmerged (May 2026). Confirm on a current nmp or move to that repo. PrismarineJS/node-minecraft-protocol#1442
PrismarineJS/mineflayer#4044 (issue, 2026) Connection hangs forever in 'configuration' state against MC 1.21.11 ( Configuration-phase hang against Paper 1.21.11 with mineflayer 4.38.0; detailed but zero replies, and 1.21.11 works elsewhere. Needs a debug log to confirm.
PrismarineJS/prismarine-auth#182 (issue, 2026) 403 Forbidden when authenticating with Titles.MinecraftJava 403 with Titles.MinecraftJava on current versions (Sep 2026); one earlier report was a config error (PrismarineJS/prismarine-auth#140). Check whether the default title still works. PrismarineJS/prismarine-auth#140

Consolidate into one tracker — 106

Item Title Evidence / reason Related
ProtoDef-io/ProtoDef#13 (issue, 2017) Add a new "toEnd" field in count 'toEnd' count / rest-of-buffer; implemented as restBuffer in ProtoDef-io/ProtoDef#55. Fold. ProtoDef-io/ProtoDef#55
ProtoDef-io/ProtoDef#20 (issue, 2017) Document variable system Document the $variable system; same docs gap as ProtoDef-io/ProtoDef#17. Fold. ProtoDef-io/ProtoDef#17
ProtoDef-io/ProtoDef#58 (issue, 2026) why is "shift" a number? 'shift' typed as number instead of boolean; fixed by ProtoDef-io/ProtoDef#59. Fold. ProtoDef-io/ProtoDef#59
ProtoDef-io/ProtoDef#60 (issue, 2026) how specify that an integer requires a minimum/maximum? Integer min/max; the PR is ProtoDef-io/ProtoDef#63. Fold. ProtoDef-io/ProtoDef#63
PrismarineJS/bedrock-protocol#693 (issue, 2026) "Illegal hardware instruction" 'Illegal hardware instruction' on macOS; fold into the macOS/raknet-native tracker PrismarineJS/bedrock-protocol#507. PrismarineJS/bedrock-protocol#507
PrismarineJS/bedrock-protocol#702 (issue, 2026) MacOs incompatibility macOS M4 trace trap in raknet-native; fold into PrismarineJS/bedrock-protocol#507. PrismarineJS/bedrock-protocol#507
PrismarineJS/bedrock-protocol#712 (issue, 2026) Error connecting to BDS script_watchdog_exception on BDS; same as PrismarineJS/bedrock-protocol#713 which was fixed (Apr 2026). Close with it. PrismarineJS/bedrock-protocol#713
PrismarineJS/bedrock-protocol#765 (issue, 2026) Cant connect to realms Cannot connect to realms without Nethernet; fold into PrismarineJS/bedrock-protocol#717 / PrismarineJS/bedrock-protocol#774. PrismarineJS/bedrock-protocol#717, PrismarineJS/bedrock-protocol#774
PrismarineJS/flying-squid#81 (issue, 2015) Handle tab completion for commands and names Tab completion (2015); the modern form is PrismarineJS/flying-squid#636 (command data graph, 1.13+). Fold. PrismarineJS/flying-squid#636
PrismarineJS/flying-squid#163 (issue, 2015) About cluster/scalability Cluster/scalability (2015) is the same discussion as the distributed-server design PrismarineJS/flying-squid#392. Fold. PrismarineJS/flying-squid#392
PrismarineJS/flying-squid#191 (issue, 2016) Make flying-squid server for Minecraft Pocket Edition. Pocket Edition server (2016) is the same ask as PrismarineJS/flying-squid#606 (bedrock support). Fold. PrismarineJS/flying-squid#606
PrismarineJS/flying-squid#457 (issue, 2020) Tab completion matches all commands/users Tab completion matching everything; fold into PrismarineJS/flying-squid#636. PrismarineJS/flying-squid#636
PrismarineJS/flying-squid#675 (issue, 2025) Vanilla server unjoinable on 1.21.X: Failed Vanilla client cannot join on 1.21.x ('Failed to verify username'); same as PrismarineJS/flying-squid#676 and PrismarineJS/node-minecraft-protocol#1340. Fold into PrismarineJS/flying-squid#676. PrismarineJS/flying-squid#676
PrismarineJS/minecraft-data#39 (issue, 2015) harvestTools should be a list in blocks.json harvestTools as a list; superseded by the tag model (PrismarineJS/minecraft-data#412) that replaces materials/harvestTools entirely. PrismarineJS/minecraft-data#412
PrismarineJS/minecraft-data#48 (issue, 2015) Add hasInventory property in blocks.json hasInventory flag per block is block-entity data; fold into PrismarineJS/minecraft-data#346. PrismarineJS/minecraft-data#346
PrismarineJS/minecraft-data#292 (issue, 2020) Bounding box of semi-empty blocks Bounding boxes of semi-empty blocks; the selection-shape data in PrismarineJS/minecraft-data#1296 (+ generator#85, PrismarineJS/node-minecraft-data#468) answers it. PrismarineJS/minecraft-data#1296, PrismarineJS/minecraft-data-generator#85, PrismarineJS/prismarine-block#125
PrismarineJS/minecraft-data#343 (issue, 2020) Support groups of tags Grouped tag data is the tags model in PrismarineJS/minecraft-data#412 / PrismarineJS/minecraft-data#1308. PrismarineJS/minecraft-data#412, PrismarineJS/minecraft-data#1308
PrismarineJS/minecraft-data#351 (issue, 2021) Have more strict audit scripts Stricter audit scripts; same as PrismarineJS/minecraft-data#461 (sanity checks), which PrismarineJS/minecraft-data#1242 implements. PrismarineJS/minecraft-data#461
PrismarineJS/minecraft-data#352 (issue, 2021) Fuel burn times Fuel burn times; the thread points at PrismarineJS/minecraft-data#290 (smelting data). Fold. PrismarineJS/minecraft-data#290
PrismarineJS/minecraft-data#462 (issue, 2021) Add tag data Add tag data; fold into PrismarineJS/minecraft-data#412 (tags replace materials), delivered by PrismarineJS/minecraft-data#1308. PrismarineJS/minecraft-data#412, PrismarineJS/minecraft-data#1308
PrismarineJS/minecraft-data#463 (issue, 2021) RFC: Tag Schema RFC tag schema; its PR PrismarineJS/minecraft-data#464 closed in 2022, the finished schema is PrismarineJS/minecraft-data#1194. Fold into PrismarineJS/minecraft-data#412. PrismarineJS/minecraft-data#412, PrismarineJS/minecraft-data#1194
PrismarineJS/minecraft-data#557 (issue, 2022) Proposal: Remove materials.json and putting the important data in bloc u9g's 2022 proposal to remove materials.json; the accepted route is the tag model tracked in PrismarineJS/minecraft-data#412 (delivered by PrismarineJS/minecraft-data#1308/#1194). Fold. PrismarineJS/minecraft-data#412, PrismarineJS/minecraft-data#1308
PrismarineJS/minecraft-wiki-extractor#13 (issue, 2016) burning time Burn times (2016); the live request is PrismarineJS/minecraft-data#290 / PrismarineJS/minecraft-wiki-extractor#352. Fold. PrismarineJS/minecraft-data#290
PrismarineJS/minecraft-wiki-extractor#14 (issue, 2016) smelting recipe Smelting recipes (2016); fold into PrismarineJS/minecraft-data#290. PrismarineJS/minecraft-data#290
PrismarineJS/mineflayer#336 (issue, 2015) Common modules 2015 'common modules' checklist; every item is done except the prismarine-world move, which PrismarineJS/mineflayer#334 tracks. Fold into PrismarineJS/mineflayer#334. PrismarineJS/mineflayer#334
PrismarineJS/mineflayer#438 (issue, 2016) Document Proxy support rom1504 marked it a duplicate of PrismarineJS/mineflayer#461 in 2017 and pointed at the node-minecraft-protocol proxy example; the outbound-proxy documentation gap is resolved by built-in proxy support in PrismarineJS/node-minecraft-protocol#1420. Fold there. PrismarineJS/node-minecraft-protocol#1420, PrismarineJS/mineflayer#461
PrismarineJS/mineflayer#909 (issue, 2020) Write design doc for mineflayer 'Write a design doc' (2020), no progress in five years; fold into the documentation tracker PrismarineJS/mineflayer#908. PrismarineJS/mineflayer#908
PrismarineJS/mineflayer#1089 (issue, 2020) Clearly address the status for each kind of user target : make a guide 2020 idea for a per-audience guide; fold into PrismarineJS/mineflayer#908. PrismarineJS/mineflayer#908
PrismarineJS/mineflayer#1138 (issue, 2020) Automatically add all examples to https://mineflayer.prismarine.js.org Show examples on the docs site; docs idea from 2020, fold into PrismarineJS/mineflayer#908. PrismarineJS/mineflayer#908
PrismarineJS/mineflayer#1141 (issue, 2020) Add a tutorial for async Async tutorial; the tutorial now uses async/await throughout, remaining docs work belongs under PrismarineJS/mineflayer#908. PrismarineJS/mineflayer#908
PrismarineJS/mineflayer#1385 (issue, 2020) Protect all methods against concurrent calls Protect methods against concurrent calls; same design space as PrismarineJS/mineflayer#1483 (task holder) and the PrismarineJS/mineflayer#3891 look-sync debate. One tracker. PrismarineJS/mineflayer#1483, PrismarineJS/mi