Actor Morpher Early Beta — Looking for Initial Testers (Patreon)

Thank you, as always, for supporting my work.

Actor Morpher has reached a point where I am ready to begin its first round of testing outside my own development environment.

I am inviting paid Patreon members to take part in this initial testing phase.

This is not a finished release or a general public launch. The purpose of this test is to identify crashes, restoration failures, visual problems, confusing behavior, and environment-specific issues as early as possible so that Actor Morpher can be made safer and more stable.

You do not need to test every feature. Trying one or two features that interest you would already be very helpful.

At a Glance

Early beta test

• Participation is completely optional.• Test only the features you are comfortable with.• Bugs and test results should be submitted through GitHub Issues.• Stop testing after a crash, persistent T-pose, missing skeleton, or failed restoration.

About Actor Morpher

Actor Morpher is a standalone Dalamud plugin for changing and inspecting the appearance of currently visible FFXIV characters and NPCs.

Its main features include:

Searching and applying Human, Demihuman, and Monster models

Restoring the appearance captured before the first change

Listing and filtering visible players and supported NPC actors

Applying an outfit to multiple Human actors with Bulk Outfit

Model application, outfit operations, and restoration inside GPose

An optional software-rendered 3D model preview

English, Japanese, German, and French UI support

Actor Morpher does not require Glamourer or Penumbra IPC.

Its primary purpose is to support mod development by making it easier to verify behavior across Human, Demihuman, and Monster character types.

What I Would Like Tested

Please test any of the following that you are comfortable with:

Whether the plugin installs, loads, and opens correctly

Whether the Actors list and its filters behave correctly

Whether Human, Demihuman, and Monster models can be searched and applied

Whether an actor is restored correctly after applying a model

Whether GPose entry, exit, model application, and restoration work correctly

Whether Bulk Outfit applies and restores equipment correctly

Whether territory changes, logout, or plugin reloads cause problems

Whether the 3D preview has missing geometry, incorrect framing, or other visual issues

Whether any UI text, translation, or explanation is unclear

Reports that something worked correctly are also valuable.

A brief report such as “I tested this feature and did not find any problems” or “This worked correctly in my environment” is very welcome.

Important Safety Notice

Actor Morpher is still an early beta under active development.

Crashes, persistent T-poses, missing skeletons, visual corruption, restoration failures, or loss of local plugin settings or data cannot be ruled out.

Stop testing and do not repeat the same operation if any of the following occurs:

FFXIV or Dalamud crashes

Restore does not return the character to the previous appearance

A T-pose or missing skeleton continues after the operation

Equipment, weapons, job, race, customization, or another unrelated property changes unexpectedly

A visual problem remains after changing territory or logging out

Please do not test during important screenshots, duties, events, or any other situation where you cannot safely stop what you are doing.

Updates to FFXIV, Dalamud, or FFXIVClientStructs may temporarily break native appearance operations. Please participate only if you are comfortable with the risks of testing third-party early beta software.

Installation

Add the following URL to Dalamud’s Custom Plugin Repositories:

https://raw.githubusercontent.com/miqote69/ActorMorpher/main/repo.json

After installation, open Actor Morpher with either of these commands:

/actormorpher

/amorph

GitHub repository:

https://github.com/miqote69/ActorMorpher

Current test version at the time of this post: v0.0.0.43

Updates may be released during the testing period. When submitting a report, please include the exact Actor Morpher version you were using when the problem occurred.

Diagnostics

Before testing model application or restoration, open Actor Morpher’s settings and do one of the following:

Set the diagnostic mode to Full Troubleshooting

Select Begin Troubleshooting Capture

When reproducing a problem, use Add Diagnostic Marker immediately before and after the issue occurs whenever possible. This makes the relevant events easier to identify.

Diagnostic logs and snapshots are stored locally. Actor Morpher does not automatically upload them anywhere.

By default, actor names and raw memory addresses are not included. Even so, please review any file before attaching it to a public GitHub Issue.

Reporting Bugs and Test Results

Please submit bugs, unexpected behavior, and test results through Actor Morpher’s GitHub Issues page:

https://github.com/miqote69/ActorMorpher/issues

Before creating a new Issue, please do a quick search to see whether the same problem has already been reported.

If a similar Issue already exists, add your information as a comment instead of opening a duplicate.

Reports may be written in either English or Japanese.

Suggested Issue Title Prefixes

Use one of the following prefixes:

[Bug] for normal bugs

[Critical] for crashes, failed restoration, or other serious problems

[Test Report] for successful or general testing results

[Feature Request] for suggestions and usability improvements

Examples:

[Bug] Appearance is not restored after restoring a Monster model

[Critical] FFXIV crashes when restoring after applying a Human model

[Test Report] Human, Demihuman, and Monster apply and restore completed successfully

[Feature Request] Save the current Model Search filter settings

What to Include in a Report

You do not need to provide every possible detail. Please include whatever information you can.

The most useful information is:

Actor Morpher version

FFXIV client language

Dalamud version, if known

Whether Penumbra or Glamourer was installed

Other appearance-related plugins in use

A short description of what happened

Steps required to reproduce the problem

What you expected to happen

What actually happened

Whether the problem occurs every time, sometimes, or only occurred once

Actor type

Feature used

Model name or Model ID

Whether GPose was active

Relevant territory or location

Screenshots, video, diagnostic snapshot, Dalamud log, or crash report when applicable

The four most important details are:

The Actor Morpher version

The steps required to reproduce the problem

The expected behavior

The actual behavior

Critical Problems

Add [Critical] to the Issue title if any of the following occurs:

FFXIV or Dalamud crashes

Restore does not return the actor to the previous appearance

A T-pose or missing skeleton persists

Weapons, job, race, customization, or another property outside the intended operation changes

The problem remains after changing territory or logging out

The same steps reproduce a crash with a high success rate

After a critical problem, do not repeatedly perform the same operation.

When it is safe and possible to do so, please attach a diagnostic snapshot, Dalamud log, or crash report.

Before Attaching Files

GitHub Issues are public.

Before uploading a file, screenshot, or video, remove or obscure any information you do not want to publish, including:

Your character name

Other players’ character names

Chat messages

Your Windows username or personal folder paths

Discord usernames or email addresses

Authentication information

Mod names or filenames that you do not want to disclose

Please also check screenshots and videos for visible player names or chat messages.

If a file contains private information and you are not sure how to remove it, do not attach the file. Submit the written Issue first without the attachment.

Feature Requests

Feature suggestions and usability feedback are also welcome through GitHub Issues.

Please use [Feature Request] at the beginning of the Issue title.

During this initial testing phase, crashes, restoration failures, persistent visual problems, and other stability issues will be prioritized over new features.

Finally

Participation in this test is completely optional. There is no disadvantage to your Patreon membership if you choose not to participate.

This test does not represent a finished release and does not guarantee that Actor Morpher will work correctly in every environment.

Reports from real environments will make a major difference in improving the plugin’s stability. Even a short comment or a report that a feature worked correctly would be appreciated.

Thank you for supporting the development of Actor Morpher, and thank you to everyone who chooses to help with this first round of testing.