What are services?

What are services?

Services are module scripts that serve a specific purpose within your experience. For example, you might have services dedicated to handling the user interface (UI), managing player points, or controlling game-specific logic.

Creating a Service

To create a service, you’ll need to place a new ModuleScript in one of the designated Knight service folders based on its purpose:

• Server-side services: src/ServerStorage/Knight

• Client-side services: src/StarterPlayer/StarterPlayerScripts/Knight

• Shared services: src/ReplicatedStorage/Knight

Default Functions

• Init(): Called during the initialization phase of the service. This is optional and typically used for setting up any necessary data or connections before the service starts.

  function Knight.Init()
      -- Initialization logic here
  end

• Start(): Called when the service is ready to begin its main functionality. This is also optional and is typically used to start processes like event listeners, timers, etc.

  function Knight.Start()
      -- Start logic here
  end

• Update(deltaTime): Called every frame. This function is optional and is used for tasks that need to be updated regularly, such as animations or game logic.

  function Knight.Update(deltaTime)
      -- Frame update logic here
  end

Configuration Options

• CanStart, CanUpdate, CanInit:

  These booleans determine whether the Start(), Update(), and Init() functions will be called.

If you're using a third-party module and don't want Knight to call its default start function, set CanStart to false.

Priority Startup

Folders named "Database" will have the first priority during initialization, followed by manual "Priority" set within the module. This is useful for ensuring that core game systems, such as data management, are loaded before other services.

The default priority levels are as follows:

• Internal Services: 4

• Objects: 3

• Services: 2

You can adjust the startup priority by setting Knight.Priority to a specific number in the script. Higher priority numbers indicate an earlier startup.

Additional Configuration

Optionally, if you have the instance named "Init" or "EnivornmentInit" or it has the collection tag "KNIGHT_IGNORE" it will be automatically ignored and not inited/imported into the framework.

We recommend using the Collection Tag only to mark Modules as in-active/disabled.

Template

Each service in Knight follows a standard template structure:

local Knight = {
    ServiceName = script.Name,
    ServiceData = {
        Author = "YourName",
        Description = "Description of what this service does"
    },
    CanStart = true,
    CanUpdate = true,
    CanInit = true,  -- Optional, defaults to true if not specified
}

function Knight:Init()
    warn(Knight.ServiceName .. " Service Initialized!")
end

function Knight:Start()
    warn(Knight.ServiceName .. " Service Started!")
end

function Knight:Update(deltaTime)
    -- This is ran every frame
end

return Knight

Example Service Class

local Knight = {
    ServiceName = script.Name,
    ServiceData = {
        Author = "YourName",
        Description = "This service manages the game's UI"
    },
    CanStart = true,
    CanUpdate = false,
}

function Knight.Init()
    -- For client services only
    print(Knight.Player.Name)  -- Prints the LocalPlayer's name
    
    -- Access shared modules and functions
    local sharedModule = Knight.Shared.SomeModule
    sharedModule:DoSomething()
    
    -- Access server or client-specific functionality
    Knight.Services.SomeOtherService:DoSomethingElse()
end

return Knight

Article & Art by vq9o