SimpleMimics Wiki

SimpleMimics Wiki

SimpleMimics adds Mimic entities that can impersonate players by copying their appearance, identity and voice.

Features

• Copies player skins
• Copies player nametags
• Records and replays player voice clips using Simple Voice Chat
• Designed for multiplayer servers
• Provides an addon API for custom behaviour

---

User Guide

How Mimics Work

A Mimic observes players and can copy their:

Appearance

Mimics can copy:

• Player skin
• Player name

The Mimic will appear as the copied player to other players.

Voice

Mimics can replay voice clips captured through Simple Voice Chat.

When a player speaks near a Mimic:

Player Voice
     |
     v
Simple Voice Chat
     |
     v
SimpleMimics Voice Handler
     |
     v
Stored Voice Clip
     |
     v
Mimic Playback

The Mimic can later use these clips to imitate the player.

---

Server Configuration

Mimic Limits

SimpleMimics prevents excessive Mimic creation.

Default limits:

Maximum Mimics Per Player: 1
Maximum Total Mimics: 3
Mimic Lifetime: 8 minutes

These limits prevent servers from being overloaded with active Mimics.

---

Developer API

SimpleMimics provides an event API for addons.

Addons should use events instead of modifying SimpleMimics internals.

Example:

MimicEvents.VOICE.register(event -> {
    return true;
});

---

Events

Voice Event

Called when a Mimic uses voice behaviour.

Example:

MimicEvents.VOICE.register(event -> {

    // Custom behaviour here

    return true;
});

Returning:

Value	Result
true	Allow the action
false	Cancel the action

---

Movement Event

Called when a Mimic attempts movement.

Example:

MimicEvents.MOVEMENT.register(event -> {

    ServerPlayer target = event.target();
    MimicEntity mimic = event.mimic();

    return true;
});

---

Creating Addons

A SimpleMimics addon can:

• Add custom Mimic behaviour
• Cancel Mimic actions
• React to Mimic events
• Create custom integrations

Example:

public class ExampleAddon {

    public static void init() {

        MimicEvents.VOICE.register(event -> {

            System.out.println(
                "Mimic voice activated"
            );

            return true;
        });
    }
}

---

Architecture

Voice System

Microphone Packet
        |
        v
Voice Handler
        |
        v
Voice Buffer
        |
        v
Recorded Clip
        |
        v
Mimic Queue
        |
        v
Playback

Mimic Management

MimicManager

 |
 +-- Player Mimic Limit
 |
 +-- Total Mimic Limit
 |
 +-- Lifetime Tracking
 |
 +-- Active Mimics

---

Troubleshooting

Mimics have no voice

Check:

• Simple Voice Chat is installed
• Players have voice enabled
• Server allows voice communication

Too many Mimics

Check:

• Mimic limits
• Server configuration
• Spawn behaviour