@hytopia.com/server-protocol 1.3.6 → 1.3.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hytopia.com/server-protocol",
-  "version": "1.3.6",
+  "version": "1.3.8",
   "main": "index.js",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"

package/packets/PacketCore.ts

@@ -33,6 +33,7 @@ export enum PacketId {
   CHUNKS = 37,
   ENTITIES = 38,
   WORLD = 39,
+  CAMERA = 40,
 
   // Debug Inbound Packet Types: 128 - 191 range
   DEBUG_CONFIG = 128,

package/packets/outbound/Camera.ts

@@ -0,0 +1,12 @@
+import { definePacket, PacketId } from '../PacketCore';
+import type { IPacket } from '../PacketCore';
+import { cameraSchema } from '../../schemas';
+import type { CameraSchema } from '../../schemas';
+import type { WorldTick } from '../PacketCore';
+
+export type CameraPacket = IPacket<typeof PacketId.CAMERA, CameraSchema> & [WorldTick];
+
+export const cameraPacketDefinition = definePacket(
+  PacketId.CAMERA,
+  cameraSchema,
+)

package/packets/outbound/index.ts

@@ -1,6 +1,7 @@
 export * from './Audios';
 export * from './Blocks';
 export * from './BlockTypes';
+export * from './Camera';
 export * from './ChatMessages';
 export * from './Chunks';
 export * from './Entities';

package/schemas/Camera.ts

@@ -0,0 +1,37 @@
+import type { JSONSchemaType } from 'ajv';
+import { vectorSchema } from './Vector';
+import type { VectorSchema } from './Vector';
+
+export type CameraSchema = {
+  f?: boolean       // first person mode
+  t?: boolean       // third person mode
+  e?: number        // entity id to fix camera to
+  et?: number       // entity id to track
+  fo?: number       // film offset, + value shifts right, - shifts left
+  ffo?: number      // first person forward offset, moves camera in (+) or out (-) relative to camera position
+  fv?: number       // field of view
+  p?: VectorSchema  // position to fix camera at
+  pt?: VectorSchema // position to track
+  h?: string[]      // player model parts to hide by partial case insensitive match of gltf node names
+  o?: VectorSchema  // offset - positional relative to target
+  z?: number        // zoom
+}
+
+export const cameraSchema: JSONSchemaType<CameraSchema> = {
+  type: 'object',
+  properties: {
+    f: { type: 'boolean', nullable: true },
+    t: { type: 'boolean', nullable: true },
+    e: { type: 'number', nullable: true },
+    et: { type: 'number', nullable: true },
+    fo: { type: 'number', nullable: true },
+    ffo: { type: 'number', nullable: true },
+    fv: { type: 'number', nullable: true },
+    p: { ...vectorSchema, nullable: true },
+    pt: { ...vectorSchema, nullable: true },
+    h: { type: 'array', items: { type: 'string' }, nullable: true },
+    o: { ...vectorSchema, nullable: true },
+    z: { type: 'number', nullable: true },
+  },
+  additionalProperties: false,
+}

package/schemas/index.ts

@@ -4,6 +4,7 @@ export * from './Block';
 export * from './Blocks';
 export * from './BlockType';
 export * from './BlockTypes';
+export * from './Camera';
 export * from './ChatMessage';
 export * from './ChatMessages';
 export * from './Chunk';