MMO Profile

Official compatibility

Element	Reference
TypeWriter	Required. Use the official TypeWriter release supported by the extension release.
Related extensions	Install the related extensions listed on this page before using entries that depend on them.

The MMO Profile extension provides a seamless bridge between Typewriter and the MMOProfiles ecosystem (MythicLib based). It automates LuckPerms permission synchronization and features an immersive 3D entity-based profile selection menu.

Features

• 3D Profile Menu — Immersive entity-based profile selection with locked camera, scroll/wheel navigation, and Paper dialog confirmations.
  • LuckPerms Sync — Automatically synchronizes permissions, groups, and metadata between real and profile UUIDs.
  • Profile Management — Actions to create, delete, and switch profiles within Typewriter sequences.
  • Entity Integration — Link entity definitions (Entity, BetterModel, ModelEngine, MythicMob NPC) to profile slots.
  • Permission Limits — Limit the number of available profiles based on player permissions.
  • Camera & Sound — Configurable camera positioning, slot offsets, WASD navigation, and custom sounds for every interaction.

Entries

Actions

• Open Profile Menu — Opens the 3D entity-based profile selection menu.
  • Switch Profile — Switch the current MMO profile.
  • Create Profile — Create a new MMO profile.
  • Delete Profile — Delete an existing MMO profile.

Manifest

• Menu Config — Configure the 3D profile selection menu.

Facts

• Profile Stat — Retrieve a statistic value for a specific MMO profile slot.

Commands

Command	Permission	Description
/tw profile	typewriter.profile.menu	Open the 3D profile selection menu
/tw profile menu	typewriter.profile.menu	Same as above

External Dependencies

• MMOProfiles (PhoenixDev)
• LuckPerms
• MythicLib
• MMOCore (optional, for class/profession stat reading)

Permissions

Permission	Description
typewriter.profile.menu	Open the MMO profile menu.

User guide

1. Create mmo_profile_menu and configure its menu, slots, item templates, and profile limits.
2. Add open_mmo_profile_menu to the sequence, command, or interaction that should open the menu.
3. Use create_mmo_profile, switch_mmo_profile, and delete_mmo_profile to manage profiles from Typewriter actions.
4. Grant typewriter.profile.menu to players allowed to open the menu and verify the related extensions before testing.
5. Test profile creation, switching, and deletion with a test account before adding entity models or statistics.

Create the entries through Add Page, Search bar, or + in the Typewriter interface. Keep mmo_profile_menu and typewriter.profile.menu exactly unchanged.

Troubleshooting

The extension is not visible

Check that the installed release matches the supported TypeWriter release and that the related extensions listed in the compatibility section are present.

An entry is missing

In the Typewriter Web panel, use the Search bar or the + button to find or create the entry with its exact identifier. Entry IDs and field names are case-sensitive; do not translate them.

The entry saves but nothing happens

Check that the entry is connected to the trigger, command, objective, event, or menu interaction required by its type. Test with optional permissions and criteria removed, then add them back one at a time.

An integration does not work

Verify the dependency and version shown in the extension card, then check the server log for the first error. Do not replace a missing dependency with a similarly named plugin unless the extension source explicitly supports it.