SocialActionMenu V10.9Update

A modern, animated and highly customizable action menu for Hytale servers. Perfect for RPG servers, MMO systems, custom commands, utility menus, server hubs and community integrations.

---

CurseForge Summary

Adds a customizable Hytale action menu with pages, command buttons, rankings, online player display, coordinates, optional clock, optional TaleTunes panel and German/English config support.

---

New in V10.9

This update focuses on the extended side UI and the new optional information panels.

Clock Panel

SocialActionMenu now includes its own clock panel.

The clock can show:

• In-game time
• Real time
• Day display
• 24-hour or 12-hour format
• German or English text labels
• Its own settings page inside the menu

HyClock is no longer required for the SocialActionMenu clock.

TaleTunes Panel

A new optional TaleTunes panel was added below the clock area.

If TaleTunes is installed and enabled on the server, SocialActionMenu can show a small radio panel with a button to open the TaleTunes radio UI.

If TaleTunes is not installed, the TaleTunes panel will not be shown.

Coordinates Display

A new coordinate display was added to the bottom info area.

Players can now see their current position directly inside the SocialActionMenu UI:

X 123   Y 64   Z -456

No extra setup is required for the coordinate display.

New Config File for Clock and TaleTunes

Clock and TaleTunes texts are now separated into their own config file:

mods/SocialActionMenu/SocialActionClock.json

This makes it easier to translate or customize the clock and TaleTunes UI without touching the main menu config.

---

Important Update Notes

Please remove older SocialActionMenu .jar files before installing this version.

If you already have an older SocialActionClock.json, the mod will still use fallback defaults, but the new values may not appear inside the file automatically.

If the new config options are missing, you can either:

• Add the missing values manually
• Or delete SocialActionClock.json once and let the mod generate a fresh version

After changing the config, use:

/socialmenureload

or restart the server.

---

Clock and TaleTunes Config

Config file:

mods/SocialActionMenu/SocialActionClock.json

Full Example Config

{
  "activeLanguage": "de",
  "defaults": {
    "enabled": true,
    "showClockPanel": true,
    "showTaleTunesPanel": true,
    "use24Hour": true,
    "showRealTime": false,
    "showDays": true
  },
  "texts": {
    "de": {
      "panelTitle": "UHR",
      "settingsButton": "EINSTELLEN",
      "disabledTime": "AUS",
      "disabledSubline": "ANZEIGE AUS",
      "realTimeLabel": "ECHTZEIT",
      "gameTimeLabel": "SPIELZEIT",
      "dayPrefix": "TAG",
      "settingsTitle": "UHR EINSTELLUNGEN",
      "settingsDescription": "Eigene SocialActionMenu-Uhr ohne HyClock.",
      "buttonToggleEnabled": "UHR AN/AUS",
      "buttonToggleFormat": "24H / 12H",
      "buttonToggleSource": "SPIELZEIT / ECHTZEIT",
      "buttonToggleDays": "TAG AN/AUS",
      "buttonRefresh": "AKTUALISIEREN",
      "buttonBack": "ZURUECK",
      "taleTunesTitle": "TALETUNES",
      "taleTunesSubline": "RADIO BEREIT",
      "taleTunesButton": "RADIO OEFFNEN"
    },
    "en": {
      "panelTitle": "CLOCK",
      "settingsButton": "SETTINGS",
      "disabledTime": "OFF",
      "disabledSubline": "DISPLAY OFF",
      "realTimeLabel": "REAL TIME",
      "gameTimeLabel": "GAME TIME",
      "dayPrefix": "DAY",
      "settingsTitle": "CLOCK SETTINGS",
      "settingsDescription": "Built-in SocialActionMenu clock without HyClock.",
      "buttonToggleEnabled": "CLOCK ON/OFF",
      "buttonToggleFormat": "24H / 12H",
      "buttonToggleSource": "GAME TIME / REAL TIME",
      "buttonToggleDays": "DAY ON/OFF",
      "buttonRefresh": "REFRESH",
      "buttonBack": "BACK",
      "taleTunesTitle": "TALETUNES",
      "taleTunesSubline": "RADIO READY",
      "taleTunesButton": "OPEN RADIO"
    }
  }
}

---

Enable or Disable Clock and TaleTunes

Hide the complete clock panel

Set this inside defaults:

"showClockPanel": false

Show the clock panel again

"showClockPanel": true

Hide the TaleTunes panel

"showTaleTunesPanel": false

Show the TaleTunes panel again

"showTaleTunesPanel": true

Important: The TaleTunes panel only appears if TaleTunes is installed and loaded on the server.

Disable only the clock display, but keep the panel/settings available

"enabled": false

Enable the clock display again

"enabled": true

Use 24-hour format

"use24Hour": true

Use 12-hour format

"use24Hour": false

Use real time

"showRealTime": true

Use in-game time

"showRealTime": false

Show day display

"showDays": true

Hide day display

"showDays": false

---

German and English Language Support

The clock and TaleTunes texts can be switched between German and English.

German

"activeLanguage": "de"

English

"activeLanguage": "en"

You can also edit all text entries manually under:

"texts": {
  "de": {
    ...
  },
  "en": {
    ...
  }
}

This allows server owners to fully customize labels, button texts and descriptions.

---

Coordinates

The coordinate display is shown automatically in the bottom info area of the SocialActionMenu.

It shows the current player position:

X / Y / Z

No extra config is required for coordinates in this version.

---

Main Features

• Custom command buttons
• Custom pages and categories
• Open the menu with ALT
• Optional ALT HUD
• Toggle ALT HUD ingame with /socialhud
• Page-based menu structure
• Supports subpages
• Supports player commands
• Supports console commands
• Supports player placeholders like {name}
• Clickable and styled chat messages
• Ranking display
• Online player display
• Player info card
• Coordinate display
• Optional clock panel
• Optional TaleTunes panel
• German and English text support for clock/TaleTunes
• Ingame config reload with /socialmenureload
• Good for RPG/MMO servers, hubs, utility menus and community servers

---

Commands

Open / use the menu

The menu opens with the ALT key.

Toggle ALT HUD

/socialhud

Use once to hide the ALT HUD. Use again to show it again.

Reload config

/socialmenureload

This reloads the SocialActionMenu config and the clock config.

---

Main Config File

The main menu config controls pages, buttons, ranking, online list, status, HUD and info panel.

mods/SocialActionMenu/SocialActionMenu.json

The clock and TaleTunes panel use their own config:

mods/SocialActionMenu/SocialActionClock.json

---

Button System

Every button can define what it should do.

Supported Action Types

Action Type	Description
PAGE	Opens another menu page
COMMAND	Runs a command
LINK	Sends a clickable rich-text link message
MESSAGE	Sends a styled chat message
BACK	Goes back to the main menu
CLOSE	Closes the menu
NONE	Empty or disabled button

Button Options

Option	Description
label	Text displayed on the button
actionType	Defines what the button does
targetPage	Page ID used by PAGE
command	Command used by COMMAND
runAs	Defines whether the command runs as player or console
message	Styled message used by LINK or MESSAGE

RunAs Options

Option	Description
PLAYER	Runs the command as the player
CONSOLE	Runs the command as the server console

You can use placeholders like:

{name}

Example:

"command": "spawn {name}",
"runAs": "CONSOLE"

---

Example Button Config

Main Menu Button Opening a Page

"button1": {
  "label": "Character",
  "actionType": "PAGE",
  "targetPage": "character",
  "command": "",
  "runAs": "PLAYER"
}

Subpage Button Running a Command

"button1": {
  "label": "Character Profile",
  "actionType": "COMMAND",
  "targetPage": "",
  "command": "lvl profile",
  "runAs": "PLAYER"
}

Back Button

"button15": {
  "label": "Back",
  "actionType": "BACK",
  "targetPage": "",
  "command": "",
  "runAs": "PLAYER"
}

Close Button

"button16": {
  "label": "Close",
  "actionType": "CLOSE",
  "targetPage": "",
  "command": "",
  "runAs": "PLAYER"
}

Clickable Link Button

{
  "label": "Discord",
  "actionType": "LINK",
  "targetPage": "",
  "command": "",
  "runAs": "PLAYER",
  "message": "<b><color:#B388FF>[DISCORD]</color></b> <color:#FFFFFF>Join our community:</color> <link:https://discord.gg/example&gt;&lt;b&gt;&lt;color:#FFD700&gt;CLICK HERE</color></b></link>"
}

---

Example SocialActionMenu Config

This is a shortened example. You can add more pages and buttons the same way.

{
  "menu": {
    "description": "Choose a category:"
  },
  "language": {
    "rankingTitle": "RANKING",
    "onlineTitle": "ONLINE PLAYERS",
    "onlineStatusOn": "ON",
    "onlineStatusOff": "OFF",
    "levelPrefix": "LVL",
    "prestigePrefix": "P",
    "statusOnlinePrefix": "ONLINE",
    "statusRamPrefix": "RAM",
    "noRankingData": "No ranking data available",
    "noOnlinePlayers": "No players online",
    "restartAlertMissing": "RestartAlert is currently not available.",
    "pageNotFound": "SocialActionMenu page not found:"
  },
  "ranking": {
    "enabled": true,
    "maxEntries": 5,
    "showPrestige": true,
    "showLevel": true,
    "showStatus": true,
    "debug": false,
    "cache": {
      "maxEntries": 250,
      "maxAgeDays": 180
    }
  },
  "onlineList": {
    "enabled": true,
    "maxEntries": 5
  },
  "status": {
    "showOnline": true,
    "showRam": true
  },
  "hud": {
    "enabled": true,
    "title": "Social Menu",
    "keyText": "ALT",
    "toggleCommand": "socialhud",
    "iconText": "",
    "side": "left",
    "horizontalOffset": 12,
    "topOffset": 276,
    "width": 112,
    "height": 191
  },
  "buttons": {
    "button1": {
      "label": "Character",
      "actionType": "PAGE",
      "targetPage": "character",
      "command": "",
      "runAs": "PLAYER"
    },
    "button2": {
      "label": "Teleport",
      "actionType": "PAGE",
      "targetPage": "teleport",
      "command": "",
      "runAs": "PLAYER"
    },
    "button3": {
      "label": "Community",
      "actionType": "PAGE",
      "targetPage": "community",
      "command": "",
      "runAs": "PLAYER"
    },
    "button16": {
      "label": "Close",
      "actionType": "CLOSE",
      "targetPage": "",
      "command": "",
      "runAs": "PLAYER"
    }
  },
  "pages": {
    "character": {
      "title": "Character",
      "description": "Profile, classes, races, augments and skill points.",
      "buttons": {
        "button1": {
          "label": "Profile",
          "actionType": "COMMAND",
          "targetPage": "",
          "command": "lvl profile",
          "runAs": "PLAYER"
        },
        "button2": {
          "label": "Classes",
          "actionType": "COMMAND",
          "targetPage": "",
          "command": "lvl classes",
          "runAs": "PLAYER"
        },
        "button15": {
          "label": "Back",
          "actionType": "BACK",
          "targetPage": "",
          "command": "",
          "runAs": "PLAYER"
        },
        "button16": {
          "label": "Close",
          "actionType": "CLOSE",
          "targetPage": "",
          "command": "",
          "runAs": "PLAYER"
        }
      }
    },
    "teleport": {
      "title": "Teleport",
      "description": "Quick travel options.",
      "buttons": {
        "button1": {
          "label": "Spawn",
          "actionType": "COMMAND",
          "targetPage": "",
          "command": "spawn {name}",
          "runAs": "CONSOLE"
        },
        "button2": {
          "label": "Home",
          "actionType": "COMMAND",
          "targetPage": "",
          "command": "tp home",
          "runAs": "PLAYER"
        },
        "button15": {
          "label": "Back",
          "actionType": "BACK",
          "targetPage": "",
          "command": "",
          "runAs": "PLAYER"
        },
        "button16": {
          "label": "Close",
          "actionType": "CLOSE",
          "targetPage": "",
          "command": "",
          "runAs": "PLAYER"
        }
      }
    }
  }
}

---

Config Migration Notice

Older SocialActionMenu versions used a simpler one-page config format.

For newer versions, use the page-based config structure with:

• buttons
• pages
• actionType
• targetPage
• command
• runAs

If you update from an older version, it is recommended to:

1. Back up your old config
2. Start the server once with the new version
3. Let the mod generate the new example config
4. Move your old buttons into the new page structure manually

---

Perfect For

• RPG servers
• MMO servers
• Community hubs
• Quest systems
• Leveling systems
• Dungeon systems
• Economy menus
• Teleport menus
• BattlePass menus
• Claim menus
• Server utility menus

---

Recommended: MultipleHUD

This mod is built to work together with:

MultipleHUD for Hytale

MultipleHUD helps with:

• Better compatibility
• Shared UI systems
• Easier integration between mods
• Consistent user experience

For the best experience, make sure MultipleHUD is installed.

---

Inspiration

This mod was inspired by Okey Mod and HyMenu.

---

Support

If you enjoy this mod, consider leaving a star on CurseForge.

---

Other Projects

Check out my other Hytale projects here:

DerFriesn CurseForge Projects