Full TypeScript rewrite. Best type defs

src/globals.d.ts

@@ -1,12 +1,13 @@
 // make process.platform also accept browser
 declare namespace NodeJS {
     interface Process {
-        platform: string;
+        //@ts-ignore
+        platform: string
         browser?: boolean
     }
 
 }
 interface NodeRequire {
     // webpack bundling
-    context: (path: string, deep: boolean, filter: RegExp) => { keys: () => string[]; (id: string): any };
+    context: (path: string, deep: boolean, filter: RegExp) => { keys: () => string[]; (id: string): any }
 }

src/index.js → src/index.ts

@@ -1,34 +1,24 @@
+import { createServer } from 'minecraft-protocol'
+
+import { testedVersions, latestSupportedVersion, oldestSupportedVersion } from './lib/version'
+import Command from './lib/command'
+import * as plugins from './lib/modules'
+import { EventEmitter } from 'events'
+import { Server as ProtocolServer } from 'minecraft-protocol'
+
 if (typeof process !== 'undefined' && !process.browser && process.platform !== 'browser' && parseInt(process.versions.node.split('.')[0]) < 18) {
   console.error('[\x1b[31mCRITICAL\x1b[0m] Node.JS 18 or newer is required')
   console.error('[\x1b[31mCRITICAL\x1b[0m] You can download the new version from https://nodejs.org/')
   console.error(`[\x1b[31mCRITICAL\x1b[0m] Your current Node.JS version is: ${process.versions.node}`)
   process.exit(1)
 }
 
-const { createServer } = require('minecraft-protocol')
-
-const EventEmitter = require('events').EventEmitter
-const { testedVersions, latestSupportedVersion, oldestSupportedVersion } = require('./lib/version')
-const Command = require('./lib/command')
-const plugins = require('./lib/plugins')
 require('emit-then').register()
 if (process.env.NODE_ENV === 'dev') {
   require('longjohn')
 }
 
-module.exports = {
-  createMCServer,
-  Behavior: require('./lib/behavior'),
-  Command: require('./lib/command'),
-  generations: require('./lib/generations'),
-  experience: require('./lib/experience'),
-  UserError: require('./lib/user_error'),
-  portal_detector: require('./lib/portal_detector'),
-  testedVersions
-}
-
-function createMCServer (options) {
-  options = options || {}
+function createMCServer (options = {}) {
   const mcServer = new MCServer()
   mcServer.connect(options)
   return mcServer
@@ -43,6 +33,7 @@ class MCServer extends EventEmitter {
   }
 
   connect (options) {
+    const server = this as unknown as Server
     const registry = require('prismarine-registry')(options.version)
     if (!registry?.version) throw new Error(`Server version '${registry?.version}' is not supported, no data for version`)
 
@@ -53,21 +44,46 @@ class MCServer extends EventEmitter {
       throw new Error(`Server version '${registry?.version}' is not supported. Oldest supported version is '${oldestSupportedVersion}'.`)
     }
 
-    this.commands = new Command({})
-    this._server = createServer(options)
+    server.commands = new Command({})
+    server._server = createServer(options)
 
-    const promises = []
+    const promises: Promise<any>[] = []
     for (const plugin of plugins.builtinPlugins) {
-      promises.push(plugin.server?.(this, options))
+      promises.push(plugin.server?.(server, options))
     }
     Promise.all(promises).then(() => {
-      this.emit('pluginsReady')
-      this.pluginsReady = true
+      server.emit('pluginsReady')
+      server.pluginsReady = true
     })
 
-    if (options.logging === true) this.createLog()
-    this._server.on('error', error => this.emit('error', error))
-    this._server.on('listening', () => this.emit('listening', this._server.socketServer.address().port))
-    this.emit('asap')
+    if (options.logging === true) server.createLog()
+    server._server.on('error', error => {
+      server.emit('error', error);
+    })
+    server._server.on('listening', () => {
+      server.emit('listening', server._server.socketServer.address().port);
+    })
+    server.emit('asap')
   }
 }
+
+declare global {
+  interface Server {
+    commands: Command
+    pluginsReady: boolean
+    _server: ProtocolServer
+    supportFeature: (feature: string) => boolean
+  }
+}
+
+export {
+  createMCServer,
+  testedVersions
+}
+
+export * as Behavior from './lib/behavior';
+export * as Command from './lib/command';
+export * as generations from './lib/generations';
+export * as experience from './lib/experience';
+export * as UserError from './lib/user_error';
+export * as portal_detector from './lib/portal_detector';

src/lib/behavior.js → src/lib/behavior.ts

@@ -1,5 +1,5 @@
-module.exports = (obj) => {
-  return async (eventName, data, func, cancelFunc) => {
+export default (obj) => {
+  return async (eventName: string, data?: any, func?: Function, cancelFunc?: Function) => {
     let hiddenCancelled = false
     let cancelled = false
     let cancelCount = 0
@@ -15,7 +15,7 @@ module.exports = (obj) => {
 
     let resp
 
-    func = func || (() => {})
+    func = func || (() => { })
 
     await obj.emitThen(eventName + '_cancel', data, cancel).catch((err) => setTimeout(() => { throw err }, 0))
     await obj.emitThen(eventName, data, cancelled, cancelCount).catch((err) => setTimeout(() => { throw err }, 0))

src/lib/command.js

@@ -1,4 +1,5 @@
-const UserError = require('./user_error')
+//@ts-check
+import UserError from './user_error'
 
 class Command {
   constructor (params, parent, hash) {
@@ -83,9 +84,10 @@ class Command {
   }
 
   tab (command, i) {
+    //@ts-ignore
     if (this.find(command)[0].params.tab) return this.find(command)[0].params.tab[i]
     return 'player'
   }
 }
 
-module.exports = Command
+export default Command

src/lib/convertInventorySlotId.js

@@ -1,5 +1,3 @@
-module.exports = { fromNBT, toNBT }
-
 const replace = {
   100: 8, 101: 7, 102: 6, 103: 5, '-106': 45
 }
@@ -28,3 +26,5 @@ function toNBT (slotId) {
   }
   return invertReplace[returnSlotId] || slot
 }
+
+export { fromNBT, toNBT }

src/lib/experience.js

@@ -1,5 +1,3 @@
-module.exports = { distanceToXpLevel, getXpLevel, getXpRequired, getBaseXpFromLevel }
-
 function distanceToXpLevel (xp, toLevel) {
   const level = getXpLevel(xp)
   if (!toLevel) toLevel = level + 1
@@ -46,3 +44,5 @@ function getBaseXpFromLevel (level) {
     return 4.5 * level * level - 162.5 * level + 2220
   }
 }
+
+export { distanceToXpLevel, getXpLevel, getXpRequired, getBaseXpFromLevel }

src/lib/plugins/animations.js → src/lib/modules/animations.ts

@@ -1,4 +1,4 @@
-module.exports.player = function (player) {
+export const player = function (player: Player) {
   player._client.on('arm_animation', () =>
     player.behavior('punch', {}, () => {
       player._writeOthersNearby('animation', {
@@ -22,3 +22,5 @@ module.exports.player = function (player) {
     }
   })
 }
+declare global {
+}

src/lib/modules/behavior.ts

@@ -0,0 +1,17 @@
+import Behavior from '../behavior'
+
+export const server = function (serv: Server) {
+  serv.behavior = Behavior(serv)
+}
+
+export const entity = function (entity) {
+  entity.behavior = Behavior(entity)
+}
+declare global {
+  interface Server {
+    behavior: ReturnType<typeof Behavior>
+  }
+  interface Entity {
+    behavior: ReturnType<typeof Behavior>
+  }
+}

src/lib/plugins/blockUpdates.js → src/lib/modules/blockUpdates.ts

@@ -1,8 +1,9 @@
-const { performance } = require('perf_hooks')
+import { performance } from 'perf_hooks'
 
 let multiBlockChangeHasTrustEdges
 class ChunkUpdates {
-  constructor () {
+  chunks: Map<string, { chunkX, chunkZ, updates }>
+  constructor() {
     this.chunks = new Map()
   }
 
@@ -14,7 +15,7 @@ class ChunkUpdates {
     if (!this.chunks.has(key)) {
       this.chunks.set(key, { chunkX, chunkZ, chunkY, updates: new Set() })
     }
-    this.chunks.get(key).updates.add(pos)
+    this.chunks.get(key)!.updates.add(pos)
   }
 
   updateCount () {
@@ -26,10 +27,10 @@ class ChunkUpdates {
   }
 
   async getMultiBlockPackets (world) {
-    const packets = []
+    const packets = [] as any[]
 
     for (const { chunkX, chunkZ, chunkY, updates } of this.chunks.values()) {
-      const records = []
+      const records = [] as any[]
       for (const p of updates.values()) {
         const state = await world.getBlockStateId(p)
 
@@ -62,7 +63,7 @@ class ChunkUpdates {
   }
 }
 
-module.exports.server = (serv, { version }) => {
+export const server = (serv: Server, { version }: Options) => {
   const registry = require('prismarine-registry')(version)
 
   multiBlockChangeHasTrustEdges = registry.supportFeature('multiBlockChangeHasTrustEdges')
@@ -187,3 +188,12 @@ module.exports.server = (serv, { version }) => {
     }
   })
 }
+declare global {
+  interface Server {
+    "MAX_UPDATES_PER_TICK": number
+    "updateBlock": (world: any, pos: any, fromTick: any, tick: any, forceNotify?: boolean, data?: null) => void
+    "notifyNeighborsOfStateChange": (world: any, pos: any, fromTick: any, tick: any, forceNotify?: boolean, data?: null) => void
+    "notifyNeighborsOfStateChangeDirectional": (world: any, pos: any, dir: any, fromTick: any, tick: any, forceNotify?: boolean, data?: null) => void
+    "onBlockUpdate": (name: any, handler: any) => void
+  }
+}

src/lib/plugins/blocks.js → src/lib/modules/blocks.ts

@@ -1,12 +1,12 @@
-const { skipMcPrefix } = require('../utils')
+import { skipMcPrefix } from '../utils'
 
-const Vec3 = require('vec3').Vec3
+import { Vec3 } from 'vec3'
 
-module.exports.player = function (player, serv, { version }) {
+export const player = function (player: Player, serv: Server) {
   player.changeBlock = async (position, blockType, blockData) => {
     serv.players
       .filter(p => p.world === player.world && player !== p)
-      .forEach(p => p.sendBlock(position, blockType, blockData))
+      .forEach(p => p.sendBlock(position, blockType/* , blockData */)) // todo
 
     await player.world.setBlockType(position, blockType)
     await player.world.setBlockData(position, blockData)
@@ -51,9 +51,9 @@ module.exports.player = function (player, serv, { version }) {
   player.setBlockAction = (position, actionId, actionParam) => serv.setBlockAction(player.world, position, actionId, actionParam)
 }
 
-module.exports.server = function (serv, { version }) {
-  const registry = require('prismarine-registry')(version)
-  const blocks = registry.blocks
+export const server = function (serv: Server, { version }: Options) {
+  const mcData = require('minecraft-data')(version)
+  const blocks = mcData.blocks
 
   serv.commands.add({
     base: 'setblock',
@@ -97,3 +97,12 @@ module.exports.server = function (serv, { version }) {
     }
   })
 }
+declare global {
+  interface Player {
+    "changeBlock": (position: any, blockType: any, blockData: any) => Promise<void>
+    "sendBlock": (position: any, blockStateId: any) => any
+    "setBlock": (position: any, stateId: any) => any
+    "sendBlockAction": (position: any, actionId: any, actionParam: any, blockType: any) => Promise<void>
+    "setBlockAction": (position: any, actionId: any, actionParam: any) => any
+  }
+}

src/lib/plugins/channels.js → src/lib/modules/channels.ts

@@ -1,6 +1,6 @@
 const PLAY = require('minecraft-protocol').states.PLAY
 
-module.exports.player = (player) => {
+export const player = (player) => {
   player.sendBrand = async (brand = 'flying-squid') => {
     if (player._client.state !== PLAY) throw new Error(`The state of the player must be PLAY (actual state: ${player._client.state})`)
     player._client.writeChannel((
@@ -18,3 +18,8 @@ module.exports.player = (player) => {
     player.sendBrand()
   })
 }
+declare global {
+  interface Player {
+    "sendBrand": (brand?: string) => Promise<void>
+  }
+}

src/lib/plugins/chat.js → src/lib/modules/chat.ts

@@ -1,5 +1,5 @@
-module.exports.server = function (serv) {
-  serv.broadcast = (message, { whitelist = serv.players, blacklist = [], system = false } = {}) => {
+export const server = function (serv: Server) {
+  serv.broadcast = (message, { whitelist = serv.players, blacklist = [], system = false }: any = {}) => {
     if (whitelist.type === 'player') whitelist = [whitelist]
 
     if (typeof message === 'string') message = serv.parseClassic(message)
@@ -45,7 +45,15 @@ module.exports.server = function (serv) {
 
   serv.parseClassic = (message) => {
     if (typeof message === 'object') return message
-    const messageList = []
+    const messageList: {
+      text,
+      color,
+      bold,
+      italic,
+      underlined,
+      strikethrough,
+      obfuscated
+    }[] = []
     let text = ''
     let nextChanged = false
     let color = 'white'
@@ -119,7 +127,7 @@ module.exports.server = function (serv) {
   }
 }
 
-module.exports.player = function (player, serv) {
+export const player = function (player: Player, serv: Server) {
   player._client.on('chat', ({ message } = {}) => {
     if (message[0] === '/') {
       player.behavior('command', { command: message.slice(1) }, ({ command }) => player.handleCommand(command))
@@ -159,3 +167,15 @@ module.exports.player = function (player, serv) {
     player._client.write('chat', { message: JSON.stringify(message), position: 2, sender: '0' })
   }
 }
+declare global {
+  interface Server {
+    "broadcast": (message: any, { whitelist, blacklist, system }?: { whitelist?: any; blacklist?: any[] | undefined; system?: boolean | undefined }) => void
+    "color": { black: string; dark_blue: string; dark_green: string; dark_cyan: string; dark_red: string; purple: string; dark_purple: string; gold: string; gray: string; grey: string; dark_gray: string; dark_grey: string; blue: string; green: string; aqua: string; cyan: string; red: string; pink: string; light_purple: string; yellow: string; white: string; random: string; obfuscated: string; bold: string; strikethrough: string; underlined: string; underline: string; italic: string; italics: string; reset: string }
+    "parseClassic": (message: any) => any
+  }
+  interface Player {
+    "chat": (message: any) => void
+    "emptyChat": (count?: number) => void
+    "system": (message: any) => void
+  }
+}

src/lib/plugins/chest.js → src/lib/modules/chest.ts

@@ -1,6 +1,7 @@
-const Vec3 = require('vec3').Vec3
+import MinecraftData from 'minecraft-data'
+import { Vec3 } from 'vec3'
 
-module.exports.server = function (serv, { version }) {
+export const server = (serv: Server, { version }: Options) => {
   serv.once('asap', () => {
     // Importing necessary libraries
     const registry = require('prismarine-registry')(version)
@@ -106,3 +107,5 @@ module.exports.server = function (serv, { version }) {
     }
   })
 }
+declare global {
+}