Skip to content
Icon

Game Framework


Version Number

Hermes is a game framework for Roblox making it easy and fast to create games.

Hermes's core includes:

  • A module loader
  • Extremely easy server-client communication functions
  • Components system

Installation

Pesde

cmd
pesde add hermes/core

Then, run:

cmd
pesde i

Wally

toml
hermes = "froststarinteractive/[email protected]"

Then, run:

cmd
wally install

Setting up your project

Your VSCode file tree should look something like this:

roblox_packages (Where Hermes is stored.)
src:
    client:
        components:
        providers:
        init.luau
    server:
        components:
        providers:
        init.luau
    shared:

Your project.json file should look something like this:

json
{
  "name": "Generic Hermes Game",
  "tree": {
    "$className": "DataModel",

    "ReplicatedStorage": {
      "Shared": {
        "$path": "src/shared"
      },
      "Packages": {
        "$path": "roblox_packages"
      }
    },

    "ServerScriptService": {
      "Server": {
        "$path": "src/server"
      },
    },

    "StarterPlayer": {
      "StarterPlayerScripts": {
        "Client": {
          "$path": "src/client"
        },
      }
    }
  }
}

Starting Hermes

First, require Hermes:

luau
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local Packages = ReplicatedStorage:FindFirstChild("Packages")

local Hermes = require(Packages.Hermes)

Adding Providers

Add your providers by calling:

luau

Hermes:Register(script.Providers:GetChildren())

Start it!

Lastly, to start Hermes use:

luau
Hermes:Fly()

Roadmap

  • [🤔] Animation System – Simplified helpers for playing and managing animations.
  • [🤔] Data Handling – Easy and reliable persistent data management.
  • [🤔] Sound Management – Simple player for sounds.

Last edit:

Released under the MIT License.