Potential TypeScript

README.md

@@ -1,4 +1,6 @@
 # Legacy Cross Play
+# I AM AWARE THE PROJECT IS BROKEN RIGHT NOW, THE CLIENT UPDATED AND IM WORNING ON A FIX.
+# Any questions, need help? Join my server: https://discord.gg/cb9rs9yfDm
 
 **This project allows Legacy Console Edition clients to join a vanilla 1.8 Java Edition server!**
 ![](https://raw.githubusercontent.com/DeveloperExotic/LegacyCrossPlay/refs/heads/main/.assets/lce1.png)

package.json

@@ -17,5 +17,9 @@
   "dependencies": {
     "minecraft-protocol": "^1.64.0",
     "prismarine-auth": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "typescript": "^5.9.3"
   }
 }

src/auth.js

@@ -6,6 +6,7 @@ const AUTH_CACHE_DIR = path.join(__dirname, "..", ".auth_cache");
 
 class MicrosoftAuth {
   constructor() {
+    /** @type {Authflow | null} */
     this.authflow = null;
     this.authenticated = false;
     this.username = null;

src/mappings/blockmapping.js

@@ -1,6 +1,9 @@
 /* --------------------------------------------------------------- */
 /*                         blockmapping.js                         */
 /* --------------------------------------------------------------- */
+/**
+ * @returns {Record<number, number>}
+ */
 function createBlockMapping() {
   return {
     0: 0,

src/mappings/entitymapping.js

@@ -1,6 +1,9 @@
 /* --------------------------------------------------------------- */
 /*                         entitymapping.js                        */
 /* --------------------------------------------------------------- */
+/**
+ * @returns {Record<string, number>}
+ */
 function createEntityTypeMapping() {
   return {
     //monsters

src/mappings/itemmapping.js

@@ -1,6 +1,9 @@
 /* --------------------------------------------------------------- */
 /*                         itemmapping.js                          */
 /* --------------------------------------------------------------- */
+/**
+ * @returns {Record<number, number>}
+ */
 function createItemMapping() {
   return {
     256: 256, //iron_shovel

src/mappings/recipemapping.js

@@ -3,6 +3,7 @@
 
 //unfinised as of 3/9/2026 (MM/DD/YY)
 
+/** @type {Record<number, string[]>} */
 module.exports = {
   //page 1
   0: [

src/mappings/soundmapping.js

@@ -1,7 +1,12 @@
 /* --------------------------------------------------------------- */
 /*                         soundmapping.js                         */
 /* --------------------------------------------------------------- */
+/**
+ * @param {string} soundName 
+ * @returns {number}
+ */
 function mapJavaSoundToLCE(soundName) {
+  /** @type {Record<string, number>} */
   const soundMap = {
     "mob.chicken.say": 0,
     "mob.chicken": 0,

src/packetreader.js

@@ -2,51 +2,79 @@
 /*                         packetreader.js                         */
 /* --------------------------------------------------------------- */
 class PacketReader {
+  /**
+   * @param {Buffer<ArrayBuffer>} buffer
+   */
   constructor(buffer) {
     this.buffer = buffer;
     this.offset = 0;
   }
 
+  /**
+   * @returns {number}
+   */
   readByte() {
     const value = this.buffer.readInt8(this.offset);
     this.offset += 1;
     return value;
   }
 
+  /**
+   * @returns {number}
+   */
   readUnsignedByte() {
     const value = this.buffer.readUInt8(this.offset);
     this.offset += 1;
     return value;
   }
 
+  /**
+   * @returns {number}
+   */
   readShort() {
     const value = this.buffer.readInt16BE(this.offset);
     this.offset += 2;
     return value;
   }
 
+  /**
+   * @returns {number}
+   */
   readInt() {
     const value = this.buffer.readInt32BE(this.offset);
     this.offset += 4;
     return value;
   }
 
+  /**
+   * @returns {bigint}
+   */
   readLong() {
     const value = this.buffer.readBigInt64BE(this.offset);
     this.offset += 8;
     return value;
   }
 
+  /**
+   * @returns {number}
+   */
+  // @ts-expect-error - Duplicate definition, identical
   readFloat() {
     const value = this.buffer.readFloatBE(this.offset);
     this.offset += 4;
     return value;
   }
 
+  /**
+   * @returns {boolean}
+   */
   readBoolean() {
     return this.readByte() !== 0;
   }
 
+  /**
+   * @returns {string}
+   */
   readString() {
     const length = this.readShort();
     let str = "";
@@ -58,18 +86,29 @@ class PacketReader {
     return str;
   }
 
+  /**
+   * @returns {number}
+   */
   readDouble() {
     const value = this.buffer.readDoubleBE(this.offset);
     this.offset += 8;
     return value;
   }
 
+  /**
+   * @returns {number}
+   */
+  // @ts-expect-error - Duplicate definition, identical
   readFloat() {
     const value = this.buffer.readFloatBE(this.offset);
     this.offset += 4;
     return value;
   }
 
+  /**
+   * @param {number} bytes
+   * @returns {void}
+   */
   skip(bytes) {
     this.offset += bytes;
   }

src/packetwriter.js

@@ -3,67 +3,116 @@
 /* --------------------------------------------------------------- */
 class PacketWriter {
   constructor() {
+    /**
+     * @type {Buffer<ArrayBuffer>[]}
+     */
     this.buffers = [];
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
   writeByte(value) {
     const buf = Buffer.allocUnsafe(1);
     buf.writeUInt8(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
+  // @ts-expect-error - Duplicate definition, identical
   writeSignedByte(value) {
     const buf = Buffer.allocUnsafe(1);
     buf.writeInt8(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
+  // @ts-expect-error - Duplicate definition, identical
   writeSignedByte(value) {
     const buf = Buffer.allocUnsafe(1);
     buf.writeInt8(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
   writeShort(value) {
     const buf = Buffer.allocUnsafe(2);
     buf.writeInt16BE(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
   writeInt(value) {
     const buf = Buffer.allocUnsafe(4);
     buf.writeInt32BE(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
   writeLong(value) {
     const buf = Buffer.allocUnsafe(8);
     buf.writeBigInt64BE(BigInt(value), 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
   writeDouble(value) {
     const buf = Buffer.allocUnsafe(8);
     buf.writeDoubleBE(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {number} value
+   * @returns {void}
+   */
   writeFloat(value) {
     const buf = Buffer.allocUnsafe(4);
     buf.writeFloatBE(value, 0);
     this.buffers.push(buf);
   }
 
+  /**
+   * @param {boolean} value
+   * @returns {void}
+   */
   writeBoolean(value) {
     this.writeByte(value ? 1 : 0);
   }
 
+  /**
+   * @param {string} str
+   * @returns {void}
+   */
   writeUTF(str) {
     const utf8Buffer = Buffer.from(str, "utf8");
     this.writeShort(utf8Buffer.length);
     this.buffers.push(utf8Buffer);
   }
 
+  /**
+   * @param {string} str
+   * @returns {void}
+   */
   writeString(str) {
     this.writeShort(str.length);
     for (let i = 0; i < str.length; i++) {
@@ -73,17 +122,28 @@ class PacketWriter {
     }
   }
 
+  /**
+   * @param {string} str
+   * @returns {void}
+   */
   writeUtf(str) {
     this.writeShort(str.length);
     for (let i = 0; i < str.length; i++) {
       this.writeShort(str.charCodeAt(i));
     }
   }
 
+  /**
+   * @param {Buffer<ArrayBuffer>} buffer
+   * @returns {void}
+   */
   writeBytes(buffer) {
     this.buffers.push(buffer);
   }
 
+  /**
+   * @returns {Buffer<ArrayBuffer>}
+   */
   toBuffer() {
     return Buffer.concat(this.buffers);
   }

src/utils.js

@@ -1,6 +1,10 @@
 /* --------------------------------------------------------------- */
 /*                            utils.js                             */
 /* --------------------------------------------------------------- */
+/**
+ * @param {number} value
+ * @returns {Buffer<ArrayBuffer>}
+ */
 function encodeVarInt(value) {
   const bytes = [];
   do {