Overview

The client-side portion of Utility Objectify is responsible for managing the behavior, lifecycle, and communication of object instances rendered on the player's machine.

It handles:

• Creating and destroying local script instances tied to entities

• Managing plugins and lifecycle hooks

• Handling remote procedure calls (RPC) from server to client

This section provides a high-level overview of what happens on the client and how to work with it.

---

🧠 Core Responsibilities

✅ 1. Object Instantiation

When an entity is rendered (OnSpawn), the library:

• Looks up all scripts registered to the entity’s model (via the @model(modelName, abstract?) or @plugin(pluginName) decorators)

• Creates a new class instance and binds it to the entity

• Initializes the lifecycle: OnAwake, OnSpawn, AfterSpawn

❌ When an entity is unrendered (OnDestroy):

• All bound script instances are destroyed

• The lifecycle method OnDestroy is called

• Memory and state tracking is cleared

---

🔧 Script Registration

🧱 Main script

🧩 Plugin System

🔌Plugin script

---

📡 RPC Client → Server

🌐 Entity-Based RPC (via self.server or self.client)

🧩 Global RPC (via Server.<method> or Client.<method>)

---

🔄 State Change Handling

@state(key, value?)

📣 Event Handling

@event("eventName", ignoreRendering?)

---

📦 Object Registry: Entities

Entities Singleton

---

🛠 Utility Functions

Framework

Object Management