Profiles
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 Profiles Extension enables distinct character slots on a single account. Each profile acts as an independent save state, perfect for RPGs allowing multiple builds.
Features
- Character Isolation — Separate inventories and stats.
- Dynamic Limits — Rank-based slot limits.
- Integrated Storage — Local or MySQL backend.
- Interactive GUI — Menu for character selection.
Architecture
Entries
User guide
- 1. Configure Settings — Start with the configuration entry: menu_config. This defines global settings for the extension. → menu_config
- 2. Trigger Actions — Use action entries to interact with the extension: switch, create, delete. Trigger them from commands, NPCs, events, or other entries. → switch → create
Commands
| Command | Description |
|---|---|
/profile | Open menu |
/profile switch <id> | Switch profile |
/profile create <name> | Create profile |
Placeholders
Prefix: %typewriter_profile_*%
| Placeholder | Description |
|---|---|
%typewriter_profile_active_name% | Current name |
%typewriter_profile_remaining% | Free slots |
Permissions
| Permission | Description |
|---|---|
profiles.use | Use the profile system. |
profiles.admin | Administrate profiles. |
profiles.switch.bypasscooldown | Switch profiles without waiting for the cooldown. |
typewriter.profiles.create | Create a profile. |
Dependencies
| Extension | Required | Usage |
|---|---|---|
| GUI Extension | Required | Menu rendering and layout system. |
| PlaceholderAPI | Optional | For @Placeholder fields. |
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.