PHPackages                             aiptu/smaccer - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. aiptu/smaccer

ActiveProject

aiptu/smaccer
=============

A PocketMine-MP plugin NPCs

v1.1.0(6mo ago)1306[4 PRs](https://github.com/AIPTU/Smaccer/pulls)MITPHPCI failing

Since Jul 31Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/AIPTU/Smaccer)[ Packagist](https://packagist.org/packages/aiptu/smaccer)[ RSS](/packages/aiptu-smaccer/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (9)Dependencies (6)Versions (14)Used By (0)

Smaccer
=======

[](#smaccer)

Smaccer is a powerful and easy-to-use PocketMine-MP plugin designed for managing NPCs (Non-Player Characters) in your Minecraft world. Whether you want to create interactive characters, organize your NPCs, or automate tasks, Smaccer provides all the necessary tools to bring your world to life.

Features
--------

[](#features)

- **Create NPCs**: Easily create new NPCs to populate your world.
- **Edit NPCs**: Modify existing NPCs to update their appearance, behavior, or properties.
- **Delete NPCs**: Remove unwanted NPCs from your world with simple commands.
- **Move NPCs**: Effortlessly move NPCs to different locations or players.
- **List NPCs**: View a comprehensive list of all NPCs in your world.
- **Teleport**: Quickly teleport to NPCs or move other players to NPCs.
- **Customizable Configuration**: Tailor the plugin's settings to fit your needs without restarting the server.
- **Manage Permissions**: Fine-tune permissions to control who can interact with and manage NPCs.
- **Server Queries**: Check the status of remote servers, including player counts and server uptime.
- **World Queries**: Monitor player counts and world statuses across multiple worlds.
- **Customizable Messages**: Define and customize the display messages for server and world queries through configuration files.
- **Asynchronous Tasks**: Perform server queries asynchronously to avoid blocking the main server thread.

Commands
--------

[](#commands)

- **`/smaccer about`**: Displays information about the plugin.
- **`/smaccer create`**: Creates a new NPC entity.
- **`/smaccer delete`**: Deletes an NPC entity.
- **`/smaccer edit`**: Edits an NPC entity.
- **`/smaccer id`**: Retrieves the ID of an NPC entity.
- **`/smaccer list`**: Lists all NPC entities in the world.
- **`/smaccer move`**: Moves an NPC entity to a specified player or location.
- **`/smaccer reload`**: Reloads the plugin configuration or emotes.
- **`/smaccer teleport`**: Teleports a player to an NPC entity or vice versa.

Permissions
-----------

[](#permissions)

Grant these permissions to specific player groups or individuals using a permissions management plugin of your choice.

PermissionDescriptionDefault`smaccer.bypass.cooldown`Allows players to bypass cooldown.op`smaccer.command.about`Allows players to display information about the plugin (`/smaccer about`).op`smaccer.command.create.self`Allows players to create their own entities (`/smaccer create`).op`smaccer.command.create.others`Allows players to create entities owned by others (`/smaccer create`).op`smaccer.command.delete.self`Allows players to delete their own entities (`/smaccer delete`).op`smaccer.command.delete.others`Allows players to delete entities owned by others (`/smaccer delete`).op`smaccer.command.edit.self`Allows players to edit their own entities (`/smaccer edit`).op`smaccer.command.edit.others`Allows players to edit entities owned by others (`/smaccer edit`).op`smaccer.command.id`Allows players to retrieve entity IDs (`/smaccer id`).op`smaccer.command.list`Allows players to list all entities in the worlds (`/smaccer list`).op`smaccer.command.move.self`Allows players to move an entity to themselves (`/smaccer move`).op`smaccer.command.move.others`Allows players to move an entity to another player (`/smaccer move`).op`smaccer.command.reload.config`Allows players to reload the configuration (`/smaccer reload`).op`smaccer.command.reload.emotes`Allows players to reload the emotes (`/smaccer reload`).op`smaccer.command.teleport.self`Allows players to teleport to an entity (`/smaccer teleport`).op`smaccer.command.teleport.others`Allows players to teleport other players to an entity (`/smaccer teleport`).opConfiguration
-------------

[](#configuration)

Smaccer offers a customizable configuration to tailor the NPC settings to your preferences. Below is an example of the configuration file:

```
# Smaccer Configuration

# Do not change this (Only for internal use)!
config-version: 1.2

# Enable or disable the auto update checker notifier.
update_notifier: true

# World Query Message Formats
# Customize how world information is displayed in the nametag.

# When all specified worlds are loaded.
# Placeholders:
#   - {world_names}: Comma-separated list of loaded world names.
#   - {count}: Total player count across loaded worlds.
world_message_format: "§aWorlds: §b{world_names} §a| Players: §e{count}"

# When some or all specified worlds are not loaded.
# Placeholders:
#   - {world_names}: Comma-separated list of loaded world names.
#   - {not_loaded_worlds}: Comma-separated list of worlds not loaded.
#   - {count}: Total player count across loaded worlds.
world_not_loaded_format: "§cWorlds: §b{world_names} §c| Not Loaded: §7{not_loaded_worlds} §c| Players: §e{count}"

# Server Query Message Formats
# Customize how server information is displayed in the nametag.

# When the server is online.
# Placeholders:
#   - {online}: Current number of players online.
#   - {max_online}: Maximum number of players allowed online.
server_online_format: "§aServer: §b{online}§a/§b{max_online} §aonline"

# When the server is offline.
server_offline_format: "§cServer: Offline"

# Default settings for NPCs.
npc-default-settings:
  # Cooldown settings for NPC commands.
  # - enabled: Whether command cooldown is enabled or not.
  # - value: Cooldown duration in seconds.
  commandCooldown:
    enabled: true
    value: 3

  # Rotation settings for NPC behavior.
  # - enabled: Whether rotation is enabled or not.
  # - maxDistance: Maximum distance for NPC rotation.
  rotation:
    enabled: true
    maxDistance: 8

  # Nametag visibility settings for NPCs.
  # - enabled: Whether nametag visibility is enabled or not.
  nametagVisible:
    enabled: true

  # Default entity visibility settings.
  # - value: Integer representing visibility level.
  #     0: Visible to everyone.
  #     1: Visible only to the creator.
  #     2: Invisible to everyone.
  entityVisibility:
    value: 0

  # Slap settings for NPCs.
  # - enabled: Whether slap-back action is enabled or not.
  # Note: Set to true if slap action is intended for human NPCs.
  slapBack:
    enabled: true

  # Cooldown settings for NPC emotes.
  # - enabled: Whether emote cooldown is enabled or not.
  # - value: Cooldown duration in seconds.
  # Note: Emotes are non-interactive gestures or expressions performed by NPCs.
  emoteCooldown:
    enabled: true
    value: 5

  # Cooldown settings for NPC action emotes.
  # - enabled: Whether action emote cooldown is enabled or not.
  # - value: Cooldown duration in seconds.
  # Note: Action emotes are interactive gestures or expressions that trigger specific actions when performed by NPCs.
  actionEmoteCooldown:
    enabled: true
    value: 5

  # Gravity settings for NPCs.
  # - enabled: Whether gravity is enabled or not.
  gravity:
    enabled: true
```

Images
------

[](#images)

[![](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image1.jpg)](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image1.jpg)

[![](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image2.jpg)](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image2.jpg)

[![](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image3.jpg)](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image3.jpg)

[![](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image4.jpg)](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image4.jpg)

[![](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image5.jpg)](https://raw.githubusercontent.com/AIPTU/Smaccer/assets/image5.jpg)

Upcoming Features
-----------------

[](#upcoming-features)

- Currently none planned. You can contribute or suggest for new features.

Credits
-------

[](#credits)

- [Bedrock-Emotes by TwistedAsylumMC](https://github.com/TwistedAsylumMC/Bedrock-Emotes) for providing the emotes.
- [CPlot by ColinHDev](https://github.com/ColinHDev/CPlot) for implementing promises.

Additional Notes
----------------

[](#additional-notes)

- If you find bugs or want to give suggestions, please visit [here](https://github.com/AIPTU/Smaccer/issues).
- We accept all contributions! If you want to contribute, please make a pull request in [here](https://github.com/AIPTU/Smaccer/pulls).

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance82

Actively maintained with recent releases

Popularity10

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~66 days

Recently: every ~103 days

Total

8

Last Release

186d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/aa0f82ae31849fc12498a3f34c511bd347db0a2c7f5892b0cb2b5d754e0d3127?d=identicon)[AIPTU](/maintainers/AIPTU)

---

Top Contributors

[![AIPTU](https://avatars.githubusercontent.com/u/85402087?v=4)](https://github.com/AIPTU "AIPTU (101 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (7 commits)")[![KRUNCHSHooT](https://avatars.githubusercontent.com/u/65598325?v=4)](https://github.com/KRUNCHSHooT "KRUNCHSHooT (2 commits)")[![ImgBotApp](https://avatars.githubusercontent.com/u/31427850?v=4)](https://github.com/ImgBotApp "ImgBotApp (1 commits)")[![poggit-bot](https://avatars.githubusercontent.com/u/22427965?v=4)](https://github.com/poggit-bot "poggit-bot (1 commits)")

### Embed Badge

![Health badge](/badges/aiptu-smaccer/health.svg)

```
[![Health](https://phpackages.com/badges/aiptu-smaccer/health.svg)](https://phpackages.com/packages/aiptu-smaccer)
```

###  Alternatives

[muqsit/invmenu

A PocketMine-MP virion to create and manage virtual inventories!

2234.2k1](/packages/muqsit-invmenu)[sof3/libasynql

1427.8k3](/packages/sof3-libasynql)[muqsit/simple-packet-handler

Handle specific data packets (virion for PMMP API 4.0.0)

426.1k3](/packages/muqsit-simple-packet-handler)[dktapps/pmforms

Form API library for PocketMine-MP plugins

522.3k1](/packages/dktapps-pmforms)[sof3/infoapi

321.2k1](/packages/sof3-infoapi)[muqsit/asynciterator

A virion that simplifies writing tasks that traverse iterators

182.9k](/packages/muqsit-asynciterator)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)